Get identity config

GET /api/v1/forward/identities/{identity_id}/templates/{template_id}/config Returns the stored Forward Identity Config DSL. This is the override layer, not the compiled runtime config.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Path parameters

Parameter	Type	Required	Description
`identity_id`	string	Yes	Forward Identity ID.
`template_id`	string	Yes	Forward Template ID.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123/templates/tmpl_support/config' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "type": "config",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "name": "CRM profile",
  "status": "active",
  "identity_config": {
    "system": {
      "mode": "append",
      "content": "Prefer CRM data when answering."
    },
    "managed_tool_config": {
      "schedule": {
        "enabled": false
      },
      "drive": {
        "enabled": true
      }
    },
    "skills": {
      "skill_019f18f2749e": {
        "enabled": true
      }
    },
    "environment_variables": {
      "CRM_REGION": {
        "op": "set",
        "value": "cn-shanghai"
      },
      "LEGACY_CRM_MODE": {
        "op": "unset"
      }
    },
    "github_repositories": {
      "source": {
        "mount_path": "/data/workspace/support-agent"
      },
      "legacy": {
        "enabled": false
      }
    }
  },
  "metadata": {},
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:00:00Z"
}

Response fields

Field	Type	Description
`type`	string	Always `config`.
`identity_config`	object	Stored user-level override DSL. For nested fields, enums, inheritance, and merge rules, see Identity config object.
`identity_config.model`	string \| object	Stored model override; an object can contain `id`, `effort`, `speed`, and `context_window`. Returns only the override layer without filling in the Template model. See Model for fields and update rules.
`identity_config.managed_tool_config`	object	Sparse Forward managed-capability switches stored for this Identity. Selectors inherited from the Template are not expanded.
`metadata`	object	Custom metadata.

Errors

HTTP	Type	Code	Trigger
401	`authentication_error`	`authentication_required`	The PAT or SAT is invalid or expired.
404	`not_found_error`	-	The Identity, Template, or Config does not exist.

Notes

Use Get Effective Config to see the compiled runtime config.
The returned identity_config is the stored override DSL. You can read it, modify it, and send it back to Upsert Identity Config.
managed_tool_config preserves the stored sparse selectors without expanding inherited entries. schedule is a bundle override for the three Schedule capabilities, and drive is an override for the Drive capability.
enabled=false in a resource map disables resources inherited from the Template.
environment_variables returns the stored set / unset override DSL. See Effective Config for compiled values.
GitHub repository overrides return stored fields such as url, mount_path, and enabled, but do not return the write-only authorization_token.

Get identity config

Headers

Path parameters

Example request

Example response

Response fields

Errors

Notes

Create or update identity config

Get effective config

​Headers

​Path parameters

​Example request

​Example response

​Response fields

​Errors

​Notes

​Related

Create or update identity config

Get effective config

Headers

Path parameters

Example request

Example response

Response fields

Errors

Notes

Related