Errors | Rarity docs

Every error carries a stable code to branch on and a doc_url that leads to its page here. message is for people and can change at any time.

The registry is also available as JSON.

Code	Status	Meaning
`accept_required`	400	The request has no `Accept` header.
`already_member`	409	This email address already belongs to a member of the organization.
`authentication_required`	401	This operation has no anonymous lane: managing webhook subscriptions needs a key.
`bulk_not_found`	404	No bulk export of this type has been generated.
`card_not_found`	404	No card has this id.
`catalog_not_found`	404	No catalog has this name.
`cursor_filter_mismatch`	400	The cursor was issued for a different combination of filters.
`cursor_order_mismatch`	400	The cursor was issued for a different `order`.
`daily_quota_exceeded`	429	The daily allowance is spent. With a key it belongs to the organization, not the key.
`email_not_verified`	403	The account's email address is not verified, so it cannot manage an organization.
`endpoint_not_found`	404	No endpoint exists at this path.
`game_not_found`	404	No game has this code.
`image_not_available`	404	This card has no image.
`internal_error`	500	Something failed on our side.
`invalid_api_key`	401	The key is not valid: it was revoked, it expired or it was never issued.
`invalid_authorization_header`	401	The `Authorization` header is not `Bearer <key>` with a key issued by Rarity. An empty `Bearer` counts.
`invalid_bulk_type`	400	The bulk type starts with something other than a letter or has characters other than lowercase letters, digits and underscores.
`invalid_card_id`	400	The card id is longer than an id can be.
`invalid_content_type`	400	The request body is not declared as JSON.
`invalid_cursor`	400	The cursor is too long, or it cannot be decoded.
`invalid_filter_value`	400	A filter has an empty value, a value that is too long, or control characters.
`invalid_format`	400	`format` is neither `json` nor `image`.
`invalid_invitation`	400	An invitation needs a valid email address and the role `owner` or `member`.
`invalid_json`	400	The request body is not valid JSON.
`invalid_key_name`	400	A key needs a name of 1 to 64 characters.
`invalid_limit`	400	`limit` is not an integer.
`invalid_order`	400	`order` is not one of the published orderings.
`invalid_query`	400	`q` could not be read.
`invalid_request_body`	400	The request body does not match the published schema.
`invalid_role`	400	A member's role is `owner` or `member`.
`invalid_since`	400	The `since` cursor is too long.
`invalid_terms_version`	400	This is not the current version of the terms.
`invalid_webhook_url`	400	The webhook URL is not an absolute `https` URL on a public host.
`invitation_limit_reached`	429	The organization has sent too many invitations.
`invitation_not_found`	404	There is no pending invitation with this id for this email address.
`key_limit_reached`	409	The organization already has the maximum number of active live keys.
`key_not_found`	404	This organization has no such key.
`key_not_rotatable`	409	Only an active live key with no expiry can be rotated.
`last_owner`	409	An organization cannot be left without an owner.
`member_not_found`	404	This organization has no such member.
`method_not_allowed`	405	This endpoint exists but does not serve this method.
`missing_parameter`	400	A required query parameter is missing.
`not_signed_in`	401	The dashboard needs a session.
`organization_disabled`	403	This organization is disabled, so it cannot be changed.
`organization_not_found`	404	You are not a member of an organization with this id.
`origin_not_allowed`	403	The dashboard accepts writes only from the site.
`owner_required`	403	Only an owner can do this.
`rate_limit_exceeded`	429	The per-minute allowance is spent.
`repeated_parameter`	400	A parameter that takes one value was sent more than once.
`terms_not_accepted`	403	The current terms have not been accepted, so keys cannot be managed yet.
`too_many_values`	400	A repeatable parameter has more values than the maximum.
`unknown_event_type`	400	Rarity does not emit this event.
`unknown_parameter`	400	This endpoint does not take this query parameter.
`user_agent_not_allowed`	400	The `User-Agent` is a library's default, such as `curl/8.5.0`.
`user_agent_required`	400	The request has no `User-Agent` header.
`webhook_backend_unavailable`	503	The webhook backend cannot be reached. Nothing was changed.
`webhook_limit_reached`	400	The account holds the maximum number of webhook endpoints.
`webhook_not_found`	404	This account has no webhook with this id.