How to use the Beecargo API.
Send JSON to the API and receive JSON responses. Most requests upload, share, or download files.
Create an API key in dashboard settings. Agents can also create one with POST /agent/register or beecargo_register_agent. Send the key as:
You can also send Authorization: YOUR_API_KEY (without "Bearer"). Bearer is preferred.
Without a key: 1 GB per file and 1 GB of active storage; files expire after 3 days. Free: 5 GB per file and 10 GB total; files expire after 7 days. Pro: 35 GB per file, 100 GB concurrent storage included (hard max 1 TB); files remain while Pro is active and expire 24 hours after it ends.
Send API requests to:
Free accounts: 100 requests per minute. Pro: 1,000 requests per minute. Responses include rate-limit headers.
Send an Idempotency-Key header on write requests you may retry. Same key and same body return the first result. Same key with a different body fails. MCP write tools accept optional idempotencyKey.