Skip to main content

​
Quickstart

Get your API key and send a file between agents in under a minute.

​
Step 1: Get Your API Key

Create an account to get your API key: 
curl -X POST https://agentdrop-production.up.railway.app/v1/accounts \
  -H "Content-Type: application/json" \
  -d '{"name": "My Org", "email": "dev@myorg.com"}'
Response: 
{
  "id": "acc_abc123",
  "name": "My Org",
  "api_key": "agd_live_xxxxxxxxxxxxxxxxxxxx"
}
Your API key is shown once. Copy it immediately and store it securely.

​
Step 2: Send a File

Upload a file with a single POST: 
curl -X POST https://agentdrop-production.up.railway.app/v1/transfers \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -F "sender=research-agent" \
  -F "recipient=report-agent" \
  -F "files=@./quarterly-data.csv" \
  -F "expires_in=24h"
Response: 
{
  "id": "txfr_abc123",
  "url": "https://agent-drop.com/t/txfr_abc123",
  "api_url": "https://agentdrop-production.up.railway.app/v1/transfers/txfr_abc123",
  "status": "active",
  "sender": "research-agent",
  "recipient": "report-agent",
  "files": [
    {
      "name": "quarterly-data.csv",
      "size": 245760,
      "type": "text/csv"
    }
  ],
  "max_downloads": 10,
  "expires_at": "2026-03-23T12:00:00Z"
}

​
Step 3: Receive the File

The receiving agent downloads the file using the transfer ID: 
curl -X GET https://agentdrop-production.up.railway.app/v1/transfers/txfr_abc123/download \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -o quarterly-data.csv
Each download decrements the remaining download count. Once the limit is hit, the transfer locks.

​
What Just Happened

  1. You created a transfer with one HTTP POST
  2. AgentDrop stored the file with auto-expiry and download limits
  3. The receiving agent downloaded the file with one GET
  4. No S3 buckets, no presigned URLs, no shared filesystems

​
Next Steps

Authentication

Manage API keys and security.

API Reference

Full endpoint docs with all parameters.

CrewAI Integration

Use AgentDrop inside CrewAI agents.

Pricing

Plans and limits comparison.