Get agent with or without credentials
Get one of the organization's agents, with or without a credential.
Get one of the organization's agents, with or without a credential.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_agent_instancesagent_id*stringuuidThe request has succeeded.
application/json- response
One agent: a person's use of an agent type, or one autonomous agent, whether or not it holds a credential.
id*uuidThe person this agent acts for; absent for an autonomous agent.
uuidagent_slug*stringWhich agent type this is, for example claude-code.
user_id?uuidThe person this agent acts for; absent for an autonomous agent.
uuiduser_display_name*stringDisplay name of the owning user.
autonomous*booleanTrue when no user owns this agent.
name*stringThe agent type's name, for example Claude Code.
seen_in*array<>Sources that have observed this agent.
created_at*stringWhen the agent was first seen.
date-timelast_seen_at?stringWhen any source last saw the agent; absent if none has given a time.
date-timeupdated_at*stringdate-timecurl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "agent_slug": "string", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "user_display_name": "string", "autonomous": true, "name": "string", "seen_in": [ "mcp" ], "created_at": "2019-08-24T14:15:22Z", "last_seen_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}