llms.txt Content
# Beecargo API
> Machine pointer for the Beecargo file-hosting REST API. Human-readable guides live on the website.
## Base URL
https://api.beecargo.net
## Authentication
Send `Authorization: Bearer YOUR_API_KEY` (API keys from the dashboard). Anonymous uploads are supported on select endpoints.
## OpenAPI
- Swagger UI: https://api.beecargo.net/docs
- OpenAPI JSON: https://api.beecargo.net/docs-json
## Canonical documentation (website)
- Developer briefing: https://beecargo.net/llms.txt
- Full documentation corpus: https://beecargo.net/llms-full.txt
- Human docs: https://beecargo.net/docs
- Agent card: https://beecargo.net/.well-known/agent.json
- MCP: https://mcp.beecargo.net/mcp
## Public endpoints (summary)
- `POST /files/upload` — direct upload (<4MB) or start multipart flow
- `POST /files/remote-upload` — fetch file from a public URL
- `GET /files/download/:fileId` — signed download URL
- `GET /files/info` — batch metadata by short codes
- `GET /files/list` — list owned files
- `GET /folders/list` — list folders
- `DELETE /files/delete` — delete file (public contract)
- `GET /health` — health check
Dashboard-only routes (session JWT or same API key where applicable): multipart under `/files/multipart/*`, presign under `/uploads/*`, billing, API keys, etc.