Skip to main content
GET /api/v1/forward/identities/{identity_id}/templates Returns the active or archived Identity Config records under a Forward Identity.

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID.

Query parameters

ParameterTypeRequiredDefaultDescription
template_idstringNo-Filter by Forward Template ID.
statusstringNoactiveFilter by active or archived.
limitintegerNo20Items per page. Maximum 100.
after_idstringNo-Cursor from the previous response’s last_id. Cannot be used with before_id.
before_idstringNo-Cursor from the previous response’s first_id. Cannot be used with after_id.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/identities/idn_019eabc123/templates?template_id=tmpl_support&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK
{
  "data": [
    {
      "type": "config",
      "id": "cfg_support",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "CRM profile",
      "status": "active",
      "effective_hash": "sha256:...",
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "cfg_support",
  "last_id": "cfg_support",
  "has_more": false
}

Response fields

FieldTypeDescription
dataarrayConfig summary objects on the current page.
first_idstring|nullID of the first config on this page.
last_idstring|nullID of the last config on this page.
has_morebooleanWhether more records remain.

Errors

HTTPTypeTrigger
400invalid_request_errorInvalid pagination parameters.
401authentication_errorPAT invalid or expired.
404not_found_errorIdentity does not exist or is not visible to the caller.

Notes

  • Cursor values come from Identity Config IDs, not Template IDs.
  • An Identity can have at most one active config for a given Template.

Create or update identity config

Get effective config