Get agent
Get an agent instance by ID.
Get an agent instance by ID.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_agent_instancesagent_instance_id*stringuuidThe request has succeeded.
application/json- response
One connected client of an agent, registered to the user who authorized it. A policy scoped to the agent applies to every instance; one scoped to an instance applies to that connection alone.
id*stringuuiduser_id?stringuuiduser_display_name*stringDisplay name of the owning user.
display_name*stringHuman-readable name for this connection, shown in the instance list.
1 <= length <= 255metadata?Connection details reported by the client the last time it connected.
created_at*stringWhen the instance was first registered.
date-timeupdated_at*stringdate-timelast_used_at?stringWhen the instance last connected to the gateway; absent if it never has.
date-timerevoked_at?stringWhen this instance's access was revoked; absent while it remains active.
date-timeagent_slug?stringWhich agent this is an instance of, for example claude-code or cursor. May be set on create to label the agent; otherwise the gateway identifies it from the connecting client.
external_id?stringIdentifier assigned by the client's own system, when it supplies one.
token_endpoint_auth_method?stringis_dcr_managed?booleancurl -X GET "https://example.com/agent-instances/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": null, "user_id": null, "user_display_name": "string", "display_name": "string", "metadata": { "client_name": "string", "client_version": "string", "protocol_version": "string", "user_agent": "string", "ip_address": "string" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "last_used_at": "2019-08-24T14:15:22Z", "revoked_at": "2019-08-24T14:15:22Z", "agent_slug": "string", "external_id": "string", "token_endpoint_auth_method": "string", "is_dcr_managed": true}