GETTING STARTED

Rate limits & errors

Limits follow the user’s plan (at least 60 req/min, 1,000 on Pro and Teams). When exceeded you get 429 with retryAfter.

Every error returns JSON with error (a stable code) and message (human readable).

Errors

400 validation_error401 invalid_token403 insufficient_scope404 file_not_found409 name_conflict413 payload_too_large429 rate_limited

Response

HTTP/1.1 403 Forbidden
{
  "error": "insufficient_scope",
  "message": "Missing scope: files.write"
}