List the Templates used by an Identity and their session statistics.
GET /api/v1/forward/identities/{identity_id}/agents
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identity_id | string | Yes | Forward Identity ID. |
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
data | array | Template usage statistics. |
data[].template_id | string | Forward Template ID. |
data[].template_name | string | Template name. |
data[].session_count | integer | Number of sessions that the Identity created with the Template. |
data[].last_active_at | string|null | Most recent activity time in RFC 3339 format. |
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 401 | authentication_error | authentication_required | The PAT or SAT is invalid, expired, or missing. |
| 404 | not_found_error | - | The Identity does not exist or is not visible to the caller. |