Skip to main content
GET
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.agent-drop.com/v1/agents \
  --header 'Authorization: <authorization>'
{
  "agents": [
    {}
  ],
  "agents[].id": "<string>",
  "agents[].agent_id": "<string>",
  "agents[].name": "<string>",
  "agents[].description": "<string>",
  "agents[].webhook_url": "<string>",
  "agents[].agent_type": "<string>",
  "agents[].connection_status": "<string>",
  "agents[].key_version": 123,
  "agents[].last_seen_at": "<string>",
  "agents[].metadata": {},
  "agents[].created_at": "<string>"
}
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

curl -X GET https://api.agent-drop.com/v1/agents \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "agents": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "agent_id": "data-pipeline",
      "name": "Data Pipeline Agent",
      "description": "Ingests raw data and produces cleaned datasets",
      "webhook_url": "https://example.com/webhooks/agentdrop",
      "agent_type": "langchain",
      "connection_status": "connected",
      "key_version": 1,
      "last_seen_at": "2026-03-28T10:30:00Z",
      "metadata": { "env": "production" },
      "created_at": "2026-03-15T09:00:00Z"
    },
    {
      "id": "7c9e2d1a-3b4f-4a5e-9d8c-6e7f0a1b2c3d",
      "agent_id": "analysis-agent",
      "name": "Analysis Agent",
      "description": null,
      "webhook_url": null,
      "agent_type": "custom",
      "connection_status": "pending",
      "key_version": 0,
      "last_seen_at": null,
      "metadata": {},
      "created_at": "2026-03-20T14:00:00Z"
    }
  ]
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key