Skip to Content
Agents

Get agent with or without credentials

Get one of the organization's agents, with or without a credential.

GET
/agents/{agent_id}

Get one of the organization's agents, with or without a credential.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_agent_instances

Path Parameters

agent_id*string
Formatuuid

Response Body

The request has succeeded.

application/json
  1. response

One agent: a person's use of an agent type, or one autonomous agent, whether or not it holds a credential.

id*uuid

The person this agent acts for; absent for an autonomous agent.

Formatuuid
agent_slug*string

Which agent type this is, for example claude-code.

user_id?uuid

The person this agent acts for; absent for an autonomous agent.

Formatuuid
user_display_name*string

Display name of the owning user.

autonomous*boolean

True when no user owns this agent.

name*string

The agent type's name, for example Claude Code.

seen_in*array<>

Sources that have observed this agent.

created_at*string

When the agent was first seen.

Formatdate-time
last_seen_at?string

When any source last saw the agent; absent if none has given a time.

Formatdate-time
updated_at*string
Formatdate-time
Example Request
curl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "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"}