Skip to main content
GET
/
v1
/
agents
/
sendable
List Sendable Agents
curl --request GET \
  --url https://api.agent-drop.com/v1/agents/sendable \
  --header 'Authorization: <authorization>'
{
  "agents": [
    {}
  ],
  "agents[].id": "<string>",
  "agents[].agent_id": "<string>",
  "agents[].name": "<string>",
  "agents[].own": true,
  "agents[].account_name": "<string>"
}
Retrieve all agents the current account can send files to. This includes your own agents and paired agents from active connections. Use this to discover agent_id values for send_file.
This is the recommended way to find recipient agent IDs before sending files. Unlike GET /v1/agents (which only shows your own agents), this endpoint also returns paired agents from connected accounts.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Response

​
agents
array
Array of sendable agent objects, with own agents listed first.

​
Sendable Agent Object

​
agents[].id
string
Internal UUID for this agent record.
​
agents[].agent_id
string
The unique slug identifier, this is what you pass to send_file as the recipient.
​
agents[].name
string
Human-readable name for the agent.
​
agents[].own
boolean
true if this agent belongs to your account, false if it’s a paired agent from a connection.
​
agents[].account_name
string
The name of the account that owns this agent. Only present for paired agents (own: false).

​
Examples

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

​
Response

{
  "agents": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "agent_id": "production-agent",
      "name": "Production Agent",
      "own": true
    },
    {
      "id": "7c9e2d1a-3b4f-4a5e-9d8c-6e7f0a1b2c3d",
      "agent_id": "roblox-bot",
      "name": "Game Backend",
      "own": false,
      "account_name": "Acme Inc."
    },
    {
      "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
      "agent_id": "analytics-agent",
      "name": "Analytics Agent",
      "own": false,
      "account_name": "Jamie Chen"
    }
  ]
}

​
Use Case: Finding a Recipient Before Sending

The most common workflow is:
  1. Call GET /v1/agents/sendable to see who you can send to
  2. Pick the agent_id of the target agent
  3. Call POST /v1/transfers with that agent_id as the recipient
This replaces the old pattern of calling GET /v1/agents + GET /v1/connections separately and trying to piece together recipient IDs.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key