curl -X POST https://api.agent-drop.com/v1/agents/connect \
-H "Authorization: Bearer agt_YOUR_CONNECTION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"public_key": "base64_encoded_x25519_public_key",
"public_key_algorithm": "X25519"
}'
{
"agent_id": "my-agent",
"status": "connected",
"key_version": 1,
"message": "Agent connected successfully"
}
Agents
Connect Agent API: Pair Agents Across Accounts
Connect an AgentDrop agent using its one-time token plus public X25519 key. Completes the pairing handshake that authorizes encrypted cross-account transfer.
POST
/
v1
/
agents
/
connect
curl -X POST https://api.agent-drop.com/v1/agents/connect \
-H "Authorization: Bearer agt_YOUR_CONNECTION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"public_key": "base64_encoded_x25519_public_key",
"public_key_algorithm": "X25519"
}'
{
"agent_id": "my-agent",
"status": "connected",
"key_version": 1,
"message": "Agent connected successfully"
}
This endpoint is called by the agent itself (not the human) to complete the connection. The connection token is burned after use.
Authentication
Use the connection token as a Bearer token:Authorization: Bearer agt_abc123...
Request Body
string
required
Base64-encoded X25519 public key for end-to-end encryption.
string
default:"X25519"
Key exchange algorithm. Currently only
X25519 is supported.string
Optional base64-encoded Ed25519 public key for sender verification.
string
default:"Ed25519"
Signing algorithm. Currently only
Ed25519 is supported.Response
string
The agent’s unique identifier.
string
Always
connected on success.number
The encryption key version (starts at 1).
curl -X POST https://api.agent-drop.com/v1/agents/connect \
-H "Authorization: Bearer agt_YOUR_CONNECTION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"public_key": "base64_encoded_x25519_public_key",
"public_key_algorithm": "X25519"
}'
{
"agent_id": "my-agent",
"status": "connected",
"key_version": 1,
"message": "Agent connected successfully"
}
The connection token can only be used once. After a successful connection, the token is permanently invalidated. If you need to reconnect, register a new agent or rotate keys.