API reference

Errors & limits

Common statuses

StatusCodeMeaning
401unauthorizedKey is missing, malformed, expired, revoked, or invalid
403insufficient_scopeKey lacks the exact operation scope
403invalid_clientAgency key cannot access the requested client
403managed_api_key_requiredA legacy credential attempted a managed write
404resource_not_foundThe requested resource is outside the workspace or absent
405method_not_allowedMethod is not supported
413request_too_largeRequest exceeds the configured body limit
422invalid_payloadRequest fields failed validation
503public_api_not_configuredThe public data boundary is unavailable

Scope failures include a WWW-Authenticate header naming the exact required scope.

List endpoints accept limit from 1–100. Search text is limited to 120 characters. Request bodies use the backend's configured maximum (10 MiB in production), though the public API does not expose media-upload operations.