Skip to main content
POST
/
v1
/
agents
/
register
curl -X POST https://agentdrop-production.up.railway.app/v1/agents/register \
  -H "Authorization: Bearer agd_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-agent",
    "name": "My Analysis Agent",
    "agent_type": "langchain"
  }'

{
  "agent": {
    "id": "uuid",
    "agent_id": "my-agent",
    "name": "My Analysis Agent",
    "agent_type": "langchain",
    "connection_status": "pending"
  },
  "connection_token": "agt_abc123...",
  "claim_code": "A3K7WP",
  "token_expires_at": "2026-03-23T13:00:00.000Z"
}

​
Request Body

​
agent_id
string
required
Unique identifier for this agent on your account. Alphanumeric, hyphens, underscores, and dots only.
​
name
string
Human-readable name for the agent.
​
description
string
Optional description of what this agent does.
​
webhook_url
string
URL to receive webhook notifications when files arrive for this agent.
​
agent_type
string
default:"custom"
Framework type. One of: custom, langchain, crewai, autogen, mastra, n8n.

​
Response

​
agent
object
The created agent record.
​
connection_token
string
One-time connection token (agt_...). Expires in 1 hour. Pass this to your agent to call POST /v1/agents/connect.
​
claim_code
string
Human-readable 6-character claim code (e.g. A3K7WP).
​
token_expires_at
string
ISO 8601 timestamp when the connection token expires.
curl -X POST https://agentdrop-production.up.railway.app/v1/agents/register \
  -H "Authorization: Bearer agd_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-agent",
    "name": "My Analysis Agent",
    "agent_type": "langchain"
  }'

{
  "agent": {
    "id": "uuid",
    "agent_id": "my-agent",
    "name": "My Analysis Agent",
    "agent_type": "langchain",
    "connection_status": "pending"
  },
  "connection_token": "agt_abc123...",
  "claim_code": "A3K7WP",
  "token_expires_at": "2026-03-23T13:00:00.000Z"
}