Overview

The Beecargo API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Authenticated users can create API keys in dashboard settings, or agents can self-register a machine bc_* key via POST /agent/register (or MCP beecargo_register_agent). Include your API key in the Authorization header using the Bearer token format (OAuth 2.0 standard):

Alternative format: You can also use Authorization: YOUR_API_KEY (without "Bearer"), but the Bearer format is recommended as it follows the OAuth 2.0 standard.

Anonymous uploads: You can also upload files without authentication. Anonymous uploads are limited to 25GB per file and expire after 15 days. Authenticated users can upload files larger than 25GB with no expiration.

All API requests should be made to:

API requests are limited to 100 requests per minute for free accounts and 1000 requests per minute for premium accounts. Rate limit information is included in response headers.