API

Errors

Every error status and code the API returns.

Errors have a JSON body with a stable code and a readable message:

error body
{"error": {"code": "not_found", "message": "environment has no published version"}}
StatusCodeMeaning
400invalid_*A malformed parameter or body. invalid_query_string: the URL's query isn't valid encoding (write a literal % as %25).
401unauthorizedMissing or invalid credentials.
401key_expiredThe API key has passed its expiry date.
403forbiddenA publishable key tried to write.
403key_scope_deniedThe key is limited to other bins or environments, or expires and so can't manage keys.
403production_admin_onlyOnly administrators change production; members work in development and staging.
403key_creator_not_adminThe key's creator is no longer an administrator, so it can't change production or manage keys.
403owner_onlyOnly the organization's owner manages billing, deletes the organization or hands it over.
403owner_protectedThe owner can't be removed or have their role changed; the owner hands the organization over instead.
422owner_cannot_leaveThe owner can't leave; make someone else the owner first, or delete the organization.
403read_only_keys_require_proPublishable (read-only) keys are part of Pro; on Free every bin is public.
403key_unattributedThe key predates attribution, so it can't create or rotate keys.
404not_foundNo such bin or version, or nothing published in the environment.
404version_prunedThe rollback target is older than the versions your plan keeps.
409bin_existsThe bin id is taken.
409key_expiredAn expired key can't be rotated; create a new one.
413payload_too_largeThe payload is over your plan's size limit.
413schema_too_largeA bin's JSON Schema can be at most 64 KiB.
422schema_validation_failedThe payload fails the schema.
422schema_too_complexValidating this payload would take more than 3 million subschema checks. Simplify repeated $refs or nested allOf/anyOf/oneOf.
422query_*The jq filter is invalid, failed at runtime, too slow, or its result too large. query_empty: it produced no output (end it with // {} to always return a value).
403over_plan_limitsThe organization has more bins or seats than its plan allows (after moving to Free), so its bins are read-only. Delete bins or remove members and invites, or upgrade.
422bin_limit_reached, seat_limit_reachedYour plan's bin or seat limit is reached.
429rate_limitedToo many requests from your IP, key, account or organization; retry after Retry-After seconds.
429daily_bin_limit_reachedYour organization created its plan's number of bins in the last 24 hours; deleting bins doesn't reset it.
429delay_limitedToo many ?delay= reads from your IP at once (4).
429query_busyToo many jq queries at once; retry after Retry-After.
503query_memoryThe jq filter needed more memory than a query may use.
503query_unavailableThe query engine could not start; retry shortly.
503write_busyToo many writes in progress on the server; retry after Retry-After.
503delay_busyToo many ?delay= reads on the server at once.
507org_storage_exceededYour organization's storage limit is reached. Delete bins or environments, or upgrade.
507storage_quota_exceededThe server's storage limit is reached. Reads and deletes still work.

Last updated 10 November 2026