GET /api/v1/forward/identities/{identity_id}/templates
Returns the active or archived Identity Config records under a Forward Identity.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identity_id | string | Yes | Forward Identity ID. |
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
template_id | string | No | - | Filter by Forward Template ID. |
status | string | No | active | Filter by active or archived. |
limit | integer | No | 20 | Items per page. Maximum 100. |
after_id | string | No | - | Cursor from the previous response’s last_id. Cannot be used with before_id. |
before_id | string | No | - | Cursor from the previous response’s first_id. Cannot be used with after_id. |
Example request
Example response
HTTP 200 OKResponse fields
| Field | Type | Description |
|---|---|---|
data | array | Config summary objects on the current page. |
first_id | string|null | ID of the first config on this page. |
last_id | string|null | ID of the last config on this page. |
has_more | boolean | Whether more records remain. |
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | Invalid pagination parameters. |
| 401 | authentication_error | PAT invalid or expired. |
| 404 | not_found_error | Identity 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.