Developers/Errors & limits

Errors & limits

Design integrations around explicit error and retry behavior.

Verified behavior

60 requests/minute per operational credential
120 requests/minute outer route/IP middleware
100 records per read page
1 MiB JSON request body
512 KiB decoded proof upload per API request

HTTPMeaning

400HTTPS / malformed JSON / non-object body

401Credential missing, invalid, expired or revoked

403Employee, scope, permission, company or package denied

404Record unavailable in credential company

409Idempotency, replay-expiry or changed-authority conflict

413Body too large

415JSON required

422Validation or workflow precondition failure

429Rate limited; honor Retry-After

500Operation failed; retain key and report X-Request-ID

503Operational API unavailable

Important

All example hostnames, IDs and tokens are placeholders. Test against staging first. The installed runtime services and exact OpenAPI contract remain authoritative for state transitions, nested schemas and additional permission checks.