Skip to main content
GET
List Agents
Retrieve all agents registered on your account, including their connection status and metadata.

Request

Headers

Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Response

agents
array
Array of agent objects.

Agent Object

agents[].id
string
Internal UUID for this agent record.
agents[].agent_id
string
The unique slug identifier you provided at registration.
agents[].name
string
Human-readable name for the agent.
agents[].description
string
Description of what this agent does.
agents[].webhook_url
string
Reserved field. Currently unused on standard plans.
agents[].agent_type
string
Framework type (e.g. custom, langchain, crewai).
agents[].connection_status
string
One of: pending, connected, disconnected.
agents[].key_version
integer
Current encryption key version.
agents[].last_seen_at
string
ISO 8601 timestamp of the agent’s last activity.
agents[].metadata
object
Custom metadata attached to the agent.
agents[].created_at
string
ISO 8601 creation timestamp.

Examples

Response

Errors