Skip to main content
Identities

Get identity config

Retrieve the Identity Config for one Identity and Template.

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

HeaderRequiredDescription
AuthorizationYesBearer <PAT or SAT>

Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID.
template_idstringYesForward 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."
    },
    "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

FieldTypeDescription
typestringAlways config.
identity_configobjectStored user-level override DSL.
metadataobjectCustom metadata.

Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredThe PAT or SAT is invalid or expired.
404not_found_error-The Identity, Template, or Config does not exist.

Notes

  • Use Get Effective Config to see the compiled runtime config.
  • 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.