Skip to main content
GET
/
v1
/
agents
/
{id}
Get Agent
curl --request GET \
  --url https://api.agent-drop.com/v1/agents/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "webhook_url": "<string>",
  "agent_type": "<string>",
  "connection_status": "<string>",
  "public_key": "<string>",
  "signing_public_key": "<string>",
  "key_version": 123,
  "last_seen_at": "<string>",
  "metadata": {},
  "created_at": "<string>"
}
Retrieve the full details of a specific agent, including its public encryption keys and connection status.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The agent’s UUID. Example: 550e8400-e29b-41d4-a716-446655440000

​
Response

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

​
Examples

curl -X GET https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "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",
  "public_key": "MCowBQYDK2VuAyEA7H8s2QXkOl...",
  "signing_public_key": "MCowBQYDK2VwAyEAb9K3n...",
  "key_version": 1,
  "last_seen_at": "2026-03-28T10:30:00Z",
  "metadata": { "env": "production" },
  "created_at": "2026-03-15T09:00:00Z"
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
403FORBIDDENYou do not own this agent
404NOT_FOUNDAgent UUID does not exist