# Error codes

Every error the API answers and the dashboard shows carries a stable `code`; an API answer also carries `doc_url`, the link to its line below. Each line says what the code means and leads to its full entry — its most frequent cause, what to do and who can do it — on the page of its family.

## What an error answer carries

- `error` — a sentence for a person, in English. It may change: never test it in code.
- `code` — the stable identifier. Test this one.
- `doc_url` — the link to the code’s section on this page, on your deployment’s own address.
- `field` — for `validation_failed`, the field of the request that was refused, as a dotted path.
- `refusal` — for a call the gateway refused, when helpful refusals are on: what was blocked, why, the rule and its owner, the compliant options, in the caller’s language.

A code not listed here belongs to one screen or one route, and its message says what to do.

## Access and sign-in

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/access)

- [`session_required`](https://www.azothos.ai/docs/errors/access#session_required) — The request carries no valid session: it reached a dashboard route without being signed in.
- [`session_expired`](https://www.azothos.ai/docs/errors/access#session_expired) — The session is older than the longest a session may last on this deployment, so it is refused even though it is still refreshed.
- [`mfa_challenge_required`](https://www.azothos.ai/docs/errors/access#mfa_challenge_required) — Your account has two-factor authentication on, and this session has not completed it yet.
- [`workspace_required`](https://www.azothos.ai/docs/errors/access#workspace_required) — The request does not name the workspace it is for.
- [`forbidden`](https://www.azothos.ai/docs/errors/access#forbidden) — Your account is signed in, but it has no access to what the request names.
- [`not_a_member`](https://www.azothos.ai/docs/errors/access#not_a_member) — You are signed in, but not as a member of the workspace this request names.
- [`admin_required`](https://www.azothos.ai/docs/errors/access#admin_required) — This action is reserved for the owners and admins of the workspace.
- [`owner_required`](https://www.azothos.ai/docs/errors/access#owner_required) — This action is reserved for the owners of the workspace.
- [`mfa_required_by_workspace`](https://www.azothos.ai/docs/errors/access#mfa_required_by_workspace) — The workspace asks every member to sign in with two-factor authentication.
- [`mfa_enrolment_required`](https://www.azothos.ai/docs/errors/access#mfa_enrolment_required) — The workspace asks its owners and admins to have two-factor authentication before they change roles, retention, API keys, the governance mode or rules.
- [`membership_lookup_failed`](https://www.azothos.ai/docs/errors/access#membership_lookup_failed) — Azoth could not check your membership, so it refused rather than guess.
- [`csrf_origin_mismatch`](https://www.azothos.ai/docs/errors/access#csrf_origin_mismatch) — The request came from a web address the app does not recognise, so it was refused to protect you from cross-site requests.
- [`second_admin_required`](https://www.azothos.ai/docs/errors/access#second_admin_required) — This action needs a second person to approve it, and the workspace has a single owner or admin.
- [`reviewer_must_differ_from_declarant`](https://www.azothos.ai/docs/errors/access#reviewer_must_differ_from_declarant) — A mandate is reviewed by someone other than the person who declared it.
- [`email_not_verified`](https://www.azothos.ai/docs/errors/access#email_not_verified) — Your e-mail address is not confirmed yet.
- [`captcha_failed`](https://www.azothos.ai/docs/errors/access#captcha_failed) — The anti-robot check of the form did not pass.
- [`invalid_credentials`](https://www.azothos.ai/docs/errors/access#invalid_credentials) — The e-mail address and password do not open an account.
- [`email_domain_not_accepted`](https://www.azothos.ai/docs/errors/access#email_domain_not_accepted) — Sign-up is refused for addresses of disposable-mail services.
- [`professional_use_required`](https://www.azothos.ai/docs/errors/access#professional_use_required) — Azoth OS is offered only to businesses and professionals: an account is opened only with the declaration that it is for a business or professional activity.
- [`weak_password`](https://www.azothos.ai/docs/errors/access#weak_password) — The sign-up refused the password as too weak.
- [`support_access_required`](https://www.azothos.ai/docs/errors/access#support_access_required) — Azoth’s staff cannot open access to the data of this workspace without an owner’s approval.
- [`permission_denied`](https://www.azothos.ai/docs/errors/access#permission_denied) — Your role in this workspace does not grant the permission this action needs.
- [`invitee_already_member`](https://www.azothos.ai/docs/errors/access#invitee_already_member) — An invitation adds a person to a workspace; it never changes the role of someone who is a member already. This address is a member’s, so no invitation was created.
- [`invite_role_not_allowed`](https://www.azothos.ai/docs/errors/access#invite_role_not_allowed) — An invitation grants its role when it is accepted, under the authority of whoever sent it: any workspace role but owner. The role asked for is not one of them, so no invitation was created.
- [`already_a_member`](https://www.azothos.ai/docs/errors/access#already_a_member) — You opened an invitation to a workspace you are a member of already. It is used up and changed nothing: your role stays as it is.
- [`org_invitee_already_member`](https://www.azothos.ai/docs/errors/access#org_invitee_already_member) — An invitation adds a person to an organisation; it never changes the role of someone who is a member already. This address is a member’s, so no invitation was created.
- [`already_an_org_member`](https://www.azothos.ai/docs/errors/access#already_an_org_member) — You opened an invitation to an organisation you are a member of already. It is used up and changed nothing: your role stays as it is.
- [`feature_disabled`](https://www.azothos.ai/docs/errors/access#feature_disabled) — The module this route belongs to is not enabled on this deployment.
- [`assistant_disabled`](https://www.azothos.ai/docs/errors/access#assistant_disabled) — The workspace has turned its assistant off: nothing answers its questions — in the app, in a chat app or through the API.
- [`origin_not_allowed`](https://www.azothos.ai/docs/errors/access#origin_not_allowed) — A browser sent this request from a page of another site. The MCP endpoints answer an MCP client, or a page of this deployment — never a page of another site, which could otherwise reach them through the browser of a person who opens it.
- [`capability_off`](https://www.azothos.ai/docs/errors/access#capability_off) — This feature runs on this deployment and the workspace’s plan includes it, but the workspace has it off — its own choice.
- [`cannot_remove_self`](https://www.azothos.ai/docs/errors/access#cannot_remove_self) — Nobody removes themselves from a workspace here: an owner or admin removes the other members.
- [`last_owner`](https://www.azothos.ai/docs/errors/access#last_owner) — A workspace always keeps one owner at least: its last owner can be neither removed nor given another role.
- [`org_admin_required`](https://www.azothos.ai/docs/errors/access#org_admin_required) — Only an admin of an organisation adds a workspace to it.
- [`owner_mfa_first`](https://www.azothos.ai/docs/errors/access#owner_mfa_first) — Requiring two-factor authentication of the workspace’s members needs it on your own account first.
- [`invite_daily_limit`](https://www.azothos.ai/docs/errors/access#invite_daily_limit) — Too many invitation e-mails were sent today — to this address, by you or from this workspace — so this one was not sent.
- [`sso_required`](https://www.azothos.ai/docs/errors/access#sso_required) — The organisation of this address signs its members in through single sign-on: a password sign-in, sign-up or reset is refused.
- [`member_not_found`](https://www.azothos.ai/docs/errors/access#member_not_found) — No member of this workspace has this id.
- [`invite_already_accepted`](https://www.azothos.ai/docs/errors/access#invite_already_accepted) — This invitation was accepted already: an invitation is used once.
- [`invite_expired`](https://www.azothos.ai/docs/errors/access#invite_expired) — This invitation has expired and can no longer be accepted.
- [`invite_email_mismatch`](https://www.azothos.ai/docs/errors/access#invite_email_mismatch) — This invitation is for another e-mail address than the signed-in account’s: only the invited address can accept it.
- [`invite_no_longer_valid`](https://www.azothos.ai/docs/errors/access#invite_no_longer_valid) — This invitation no longer holds: the person who sent it can no longer grant the role it offers.
- [`invite_already_pending`](https://www.azothos.ai/docs/errors/access#invite_already_pending) — An invitation already waits for this address, so no second one was created.
- [`account_email_missing`](https://www.azothos.ai/docs/errors/access#account_email_missing) — The signed-in account has no e-mail address, and this action needs one: an invitation is accepted by its address, a test e-mail is sent to it.
- [`org_role_protected`](https://www.azothos.ai/docs/errors/access#org_role_protected) — In an organisation, nobody changes their own role, and the owner’s role is neither changed nor removed.
- [`signup_failed`](https://www.azothos.ai/docs/errors/access#signup_failed) — The account could not be created, for a reason the sign-up does not give.
- [`only_workspace`](https://www.azothos.ai/docs/errors/access#only_workspace) — This is the only workspace of your account, so it is not deleted on its own.

## API keys and the person a call is for

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/keys)

- [`api_key_invalid`](https://www.azothos.ai/docs/errors/keys#api_key_invalid) — The Azoth API key sent with the call matches no active key.
- [`api_key_missing`](https://www.azothos.ai/docs/errors/keys#api_key_missing) — The call carries no Azoth API key.
- [`api_key_scope_denied`](https://www.azothos.ai/docs/errors/keys#api_key_scope_denied) — The key is valid, but it is limited — to scopes (the parts of the API it may call), to connectors or to environments — and this call falls outside those limits. At ingest, the answer’s `dimension` says which limit refused it: `connector` or `environment`.
- [`api_key_name_taken`](https://www.azothos.ai/docs/errors/keys#api_key_name_taken) — A live key of the workspace already has the name asked for: two live keys of one workspace never share a name.
- [`api_key_role_denied`](https://www.azothos.ai/docs/errors/keys#api_key_role_denied) — The key is valid, but its role — read, write or admin — is below what this route needs: a read key cannot call a route that writes, and an export of the workspace’s settings needs an admin key.
- [`ip_not_allowed`](https://www.azothos.ai/docs/errors/keys#ip_not_allowed) — The key is valid, but the call came from an address outside the workspace’s IP allowlist: the workspace accepts its API keys only from the addresses it lists.
- [`on_behalf_of_not_allowed`](https://www.azothos.ai/docs/errors/keys#on_behalf_of_not_allowed) — This call was blocked: its API key may not name the person it is for.
- [`human_identity_required`](https://www.azothos.ai/docs/errors/keys#human_identity_required) — This call was blocked: it does not name the person it is for.
- [`identity_unavailable`](https://www.azothos.ai/docs/errors/keys#identity_unavailable) — This call was blocked: the person it is for could not be checked.
- [`invalid_on_behalf_of`](https://www.azothos.ai/docs/errors/keys#invalid_on_behalf_of) — The `X-Azoth-On-Behalf-Of` header is not an identifier of a person Azoth can read.
- [`key_not_bound_to_agent`](https://www.azothos.ai/docs/errors/keys#key_not_bound_to_agent) — The MCP gateway answers only an API key bound to one agent — the agent whose mandate decides what it may call — and this key is bound to none.
- [`invalid_key_identity`](https://www.azothos.ai/docs/errors/keys#invalid_key_identity) — A personal key always speaks for its owner: it cannot also name other people.

## Model providers and the trial key

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/providers)

- [`provider_key_rejected`](https://www.azothos.ai/docs/errors/providers#provider_key_rejected) — The model provider refused the API key you entered, so it was not saved.
- [`provider_permission_denied`](https://www.azothos.ai/docs/errors/providers#provider_permission_denied) — The model provider accepted the workspace's API key but refused this call (HTTP 403).
- [`provider_key_unusable`](https://www.azothos.ai/docs/errors/providers#provider_key_unusable) — The text entered is not an API key the provider accepts for model calls, so it was not saved.
- [`provider_key_storage_unavailable`](https://www.azothos.ai/docs/errors/providers#provider_key_storage_unavailable) — Azoth could not encrypt the key, so it did not store it: this deployment cannot store provider keys right now.
- [`provider_not_connected`](https://www.azothos.ai/docs/errors/providers#provider_not_connected) — The call goes to a provider the workspace has no API key for.
- [`provider_model_not_found`](https://www.azothos.ai/docs/errors/providers#provider_model_not_found) — The provider does not offer this model, or your key cannot use it.
- [`azure_config_required`](https://www.azothos.ai/docs/errors/providers#azure_config_required) — A call to Azure OpenAI names neither the resource nor the deployment it is for, so it cannot be sent.
- [`azure_endpoint_not_allowed`](https://www.azothos.ai/docs/errors/providers#azure_endpoint_not_allowed) — The `azureEndpoint` of a call to Azure OpenAI is not an Azure OpenAI host, so the workspace's key is not sent to it.
- [`invalid_azure_deployment`](https://www.azothos.ai/docs/errors/providers#invalid_azure_deployment) — The `azureDeployment` of a call to Azure OpenAI is not a deployment name Azoth can put in the request.
- [`endpoint_url_not_allowed`](https://www.azothos.ai/docs/errors/providers#endpoint_url_not_allowed) — An address Azoth was asked to call — an Ollama base URL, an audit-export destination, an S3 endpoint — is refused before any request: it is not a public address.
- [`ollama_endpoint_missing`](https://www.azothos.ai/docs/errors/providers#ollama_endpoint_missing) — This call was blocked: this workspace has no Ollama address.
- [`ollama_endpoint_not_declared`](https://www.azothos.ai/docs/errors/providers#ollama_endpoint_not_declared) — This call was blocked: it named an Ollama address this workspace did not save.
- [`provider_rate_limited`](https://www.azothos.ai/docs/errors/providers#provider_rate_limited) — The provider refused the call because of a rate limit or a credit limit on your account with it.
- [`provider_payment_required`](https://www.azothos.ai/docs/errors/providers#provider_payment_required) — The model provider refused the call for a billing reason (HTTP 402, or a refusal its error names as one).
- [`provider_request_too_large`](https://www.azothos.ai/docs/errors/providers#provider_request_too_large) — The model provider refused the call because the request is larger than it accepts for the model (HTTP 413).
- [`provider_request_rejected`](https://www.azothos.ai/docs/errors/providers#provider_request_rejected) — The model provider refused the call without serving it (HTTP 400, 422 or another 4xx), for a reason a retry does not fix.
- [`provider_not_supported`](https://www.azothos.ai/docs/errors/providers#provider_not_supported) — This call was blocked: a rule sends it to a provider this endpoint cannot reach.
- [`provider_failure`](https://www.azothos.ai/docs/errors/providers#provider_failure) — The provider did not answer.
- [`onboarding_no_provider`](https://www.azothos.ai/docs/errors/providers#onboarding_no_provider) — This first call was not sent: no model provider is connected to the workspace.
- [`trial_exhausted`](https://www.azothos.ai/docs/errors/providers#trial_exhausted) — The Azoth trial key answers no more calls for this workspace.
- [`trial_unavailable`](https://www.azothos.ai/docs/errors/providers#trial_unavailable) — The Azoth trial key cannot answer this call.
- [`trial_limits_exceeded`](https://www.azothos.ai/docs/errors/providers#trial_limits_exceeded) — This call is outside what the Azoth trial key answers.
- [`trial_not_eligible`](https://www.azothos.ai/docs/errors/providers#trial_not_eligible) — The Azoth trial key is offered only to workspaces on Free or in their trial.
- [`trial_already_used`](https://www.azothos.ai/docs/errors/providers#trial_already_used) — The Azoth trial key is offered once per person.
- [`egress_blocked`](https://www.azothos.ai/docs/errors/providers#egress_blocked) — This call was blocked: this deployment cannot reach ‹provider›.
- [`secnumcloud_blocked`](https://www.azothos.ai/docs/errors/providers#secnumcloud_blocked) — This call was blocked: the provider is not SecNumCloud-certified.

## Checks at the gateway

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/gateway)

- [`policy_blocked`](https://www.azothos.ai/docs/errors/gateway#policy_blocked) — This call was blocked by a rule of your workspace.
- [`sovereignty_blocked`](https://www.azothos.ai/docs/errors/gateway#sovereignty_blocked) — This call was blocked by the data-residency policy.
- [`jurisdiction_blocked`](https://www.azothos.ai/docs/errors/gateway#jurisdiction_blocked) — This call was blocked by the law that applies to it.
- [`kill_switch_active`](https://www.azothos.ai/docs/errors/gateway#kill_switch_active) — This call was blocked: the emergency stop is on.
- [`kill_switch_unavailable`](https://www.azothos.ai/docs/errors/gateway#kill_switch_unavailable) — This call was blocked: the emergency-stop check could not run.
- [`data_exfiltration_blocked`](https://www.azothos.ai/docs/errors/gateway#data_exfiltration_blocked) — This call was blocked: the message contains secret content.
- [`prompt_injection_blocked`](https://www.azothos.ai/docs/errors/gateway#prompt_injection_blocked) — This call was blocked: the message reads as an attempt to override the model’s instructions.
- [`redaction_failed`](https://www.azothos.ai/docs/errors/gateway#redaction_failed) — This call was blocked: its personal data could not be masked.
- [`governance_error`](https://www.azothos.ai/docs/errors/gateway#governance_error) — This call was blocked: the governance checks could not run.
- [`loop_detected`](https://www.azothos.ai/docs/errors/gateway#loop_detected) — This call was blocked: the same call repeated in a loop.
- [`tenant_concurrency_limit`](https://www.azothos.ai/docs/errors/gateway#tenant_concurrency_limit) — This call was blocked: too many calls are running at once.
- [`human_review_required`](https://www.azothos.ai/docs/errors/gateway#human_review_required) — This call is waiting for a person to approve it.
- [`human_review_not_resumable`](https://www.azothos.ai/docs/errors/gateway#human_review_not_resumable) — This call was blocked: it needs a human approval, and it cannot be held.
- [`approval_expired`](https://www.azothos.ai/docs/errors/gateway#approval_expired) — This call was not run: its approval expired.
- [`ungrounded_answer`](https://www.azothos.ai/docs/errors/gateway#ungrounded_answer) — This answer was not returned: its sources do not support enough of it.
- [`grounding_review_required`](https://www.azothos.ai/docs/errors/gateway#grounding_review_required) — This answer is waiting for a person to check it.
- [`grounding_requires_complete_answer`](https://www.azothos.ai/docs/errors/gateway#grounding_requires_complete_answer) — This call was blocked: its answer must be checked before it is sent.
- [`pending`](https://www.azothos.ai/docs/errors/gateway#pending) — The approval this request waits for has not been decided yet: the held call has not run, the held answer is not handed over.
- [`rejected`](https://www.azothos.ai/docs/errors/gateway#rejected) — A reviewer rejected the approval this request waits for: the held call will never run, the held answer will never be handed over.
- [`already_executed`](https://www.azothos.ai/docs/errors/gateway#already_executed) — The held call of this approval has run already: an approval runs its call once.
- [`already_released`](https://www.azothos.ai/docs/errors/gateway#already_released) — The held answer of this approval was handed over already: it is handed over once, then erased.
- [`not_requester`](https://www.azothos.ai/docs/errors/gateway#not_requester) — Only the API key that sent a held call can run it once it is approved.
- [`idempotency_key_invalid`](https://www.azothos.ai/docs/errors/gateway#idempotency_key_invalid) — The `Idempotency-Key` header is empty, too long, or holds a character it may not hold.
- [`idempotency_key_reused`](https://www.azothos.ai/docs/errors/gateway#idempotency_key_reused) — A call already used this `Idempotency-Key` within the hour with another body: one key names one call.
- [`idempotency_key_in_progress`](https://www.azothos.ai/docs/errors/gateway#idempotency_key_in_progress) — The first call with this `Idempotency-Key` has not answered yet: it is never run a second time meanwhile.
- [`idempotency_replay_unavailable`](https://www.azothos.ai/docs/errors/gateway#idempotency_replay_unavailable) — The first call with this `Idempotency-Key` was answered, but its answer was not kept: a retry gets neither that answer nor a second model call.
- [`approval_pending`](https://www.azothos.ai/docs/errors/gateway#approval_pending) — The step this agent execution paused on still waits for a reviewer’s decision: nothing was run.
- [`approval_rejected`](https://www.azothos.ai/docs/errors/gateway#approval_rejected) — A reviewer rejected the step this agent execution paused on: the step will not run, and the execution cannot be resumed.
- [`approval_not_found`](https://www.azothos.ai/docs/errors/gateway#approval_not_found) — This agent execution has no approval request left to resume it with.
- [`already_resumed`](https://www.azothos.ai/docs/errors/gateway#already_resumed) — The approved step of this execution has run already: an approval runs its step once.
- [`execution_not_found`](https://www.azothos.ai/docs/errors/gateway#execution_not_found) — No agent execution has this id in this workspace.
- [`not_awaiting_approval`](https://www.azothos.ai/docs/errors/gateway#not_awaiting_approval) — This agent execution is not paused for an approval, so there is nothing to resume.
- [`agent_plan_invalid`](https://www.azothos.ai/docs/errors/gateway#agent_plan_invalid) — The plan the agent’s planner made did not pass its checks, so nothing ran. The answer’s `details` lists what failed.

## Mandates: systems and agents

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/mandates)

- [`usecase_unresolved`](https://www.azothos.ai/docs/errors/mandates#usecase_unresolved) — This call was blocked: it is not tied to any mandate.
- [`usecase_not_approved`](https://www.azothos.ai/docs/errors/mandates#usecase_not_approved) — This call was blocked: its mandate is not approved yet.
- [`usecase_divergence`](https://www.azothos.ai/docs/errors/mandates#usecase_divergence) — This call was blocked: it does not match its approved mandate.
- [`mandate_suspended`](https://www.azothos.ai/docs/errors/mandates#mandate_suspended) — This call was blocked: its mandate is suspended.
- [`mandate_expired`](https://www.azothos.ai/docs/errors/mandates#mandate_expired) — This call was blocked: its mandate has ended.
- [`usecase_prohibited`](https://www.azothos.ai/docs/errors/mandates#usecase_prohibited) — This call was blocked: its mandate is classified as a prohibited practice.
- [`ai_act_class_required`](https://www.azothos.ai/docs/errors/mandates#ai_act_class_required) — A mandate is approved only with its EU AI Act risk class.
- [`mandate_incomplete`](https://www.azothos.ai/docs/errors/mandates#mandate_incomplete) — A mandate is approved only once it names an accountable person and an end date.
- [`mandant_not_member`](https://www.azothos.ai/docs/errors/mandates#mandant_not_member) — The person who answers for a mandate must be a member of the workspace.
- [`mandate_end_in_past`](https://www.azothos.ai/docs/errors/mandates#mandate_end_in_past) — The end date given for the mandate has already passed.
- [`mandate_end_too_far`](https://www.azothos.ai/docs/errors/mandates#mandate_end_too_far) — A mandate lasts three years at most.
- [`mandate_delegation_exceeded`](https://www.azothos.ai/docs/errors/mandates#mandate_delegation_exceeded) — The mandate of a sub-agent goes beyond the mandate of its parent agent.
- [`mandate_required`](https://www.azothos.ai/docs/errors/mandates#mandate_required) — The request names no mandate.
- [`mandate_not_found`](https://www.azothos.ai/docs/errors/mandates#mandate_not_found) — The mandate named is not in this workspace.
- [`usecase_not_found`](https://www.azothos.ai/docs/errors/mandates#usecase_not_found) — This system does not exist in this workspace.
- [`agent_not_found`](https://www.azothos.ai/docs/errors/mandates#agent_not_found) — No agent of this workspace has this id.
- [`agent_archived`](https://www.azothos.ai/docs/errors/mandates#agent_archived) — The agent is archived: it is read-only, and nothing runs for it — no execution, no tool call, no new mandate, key or red-team campaign.
- [`usecase_archived`](https://www.azothos.ai/docs/errors/mandates#usecase_archived) — This call was blocked: its mandate is archived.
- [`usecase_not_archived`](https://www.azothos.ai/docs/errors/mandates#usecase_not_archived) — This mandate is not archived, so there is nothing to unarchive.
- [`usecase_is_default`](https://www.azothos.ai/docs/errors/mandates#usecase_is_default) — This mandate is the workspace’s default use case, so it is not archived.
- [`redteam_campaign_running`](https://www.azothos.ai/docs/errors/mandates#redteam_campaign_running) — A red-team campaign is still testing this mandate, so it is not archived yet.
- [`human_reviewer_required`](https://www.azothos.ai/docs/errors/mandates#human_reviewer_required) — Approving or rejecting a system is a person’s act, signed in to the dashboard: an API key may declare a system, never review it.
- [`mcp_tool_changed`](https://www.azothos.ai/docs/errors/mandates#mcp_tool_changed) — The MCP tool you reviewed is no longer the definition the catalogue holds, so your review was not applied.
- [`identity_missing`](https://www.azothos.ai/docs/errors/mandates#identity_missing) — An agent receives a mandate only once it has an identity: a person who answers for it.
- [`identity_revoked`](https://www.azothos.ai/docs/errors/mandates#identity_revoked) — This agent’s identity is revoked: it can no longer be changed.
- [`parent_not_found`](https://www.azothos.ai/docs/errors/mandates#parent_not_found) — The parent named is not another agent of this workspace.
- [`parent_loop`](https://www.azothos.ai/docs/errors/mandates#parent_loop) — This parent would make a loop of agents: an agent never delegates to one of its own ancestors.
- [`mcp_tool_not_approved`](https://www.azothos.ai/docs/errors/mandates#mcp_tool_not_approved) — The mandate names an MCP tool the catalogue has not approved.
- [`version_conflict`](https://www.azothos.ai/docs/errors/mandates#version_conflict) — Another version of this mandate was created at the same moment, so this one was not saved.
- [`name_taken`](https://www.azothos.ai/docs/errors/mandates#name_taken) — An MCP server with this name is already in the catalogue.
- [`prohibited_practice_requires_exception`](https://www.azothos.ai/docs/errors/mandates#prohibited_practice_requires_exception) — A system with a blocking flag is not approved as it stands: it is rejected, or approved with a documented exception.
- [`exception_requires_justification`](https://www.azothos.ai/docs/errors/mandates#exception_requires_justification) — A documented exception needs a written justification of 200 characters at least.
- [`exception_requires_attachment`](https://www.azothos.ai/docs/errors/mandates#exception_requires_attachment) — A documented exception needs the reference of the document that supports it.
- [`redteam_gate`](https://www.azothos.ai/docs/errors/mandates#redteam_gate) — A high-risk system is approved only after a recent red-team campaign that reached the workspace’s threshold, or under a waiver in force.
- [`mandate_models_empty`](https://www.azothos.ai/docs/errors/mandates#mandate_models_empty) — A mandate’s list of models names one model at least.
- [`mandate_models_exist`](https://www.azothos.ai/docs/errors/mandates#mandate_models_exist) — This mandate already has its list of models: it grows only from a comparison run that held.
- [`mandate_models_not_active`](https://www.azothos.ai/docs/errors/mandates#mandate_models_not_active) — This mandate’s list of models is not in force, so nothing can be added to it.
- [`replay_not_validated`](https://www.azothos.ai/docs/errors/mandates#replay_not_validated) — A model is added to a mandate only from a comparison run that completed and passed.
- [`unpriced_model`](https://www.azothos.ai/docs/errors/mandates#unpriced_model) — This model has no price, so its cost could not be capped: it is never called.
- [`no_category`](https://www.azothos.ai/docs/errors/mandates#no_category) — None of the categories chosen applies to this target.
- [`nothing_to_replay`](https://www.azothos.ai/docs/errors/mandates#nothing_to_replay) — This campaign has no failed probe to run again.
- [`source_running`](https://www.azothos.ai/docs/errors/mandates#source_running) — The campaign whose failed probes were asked for again has not finished yet.
- [`library_changed`](https://www.azothos.ai/docs/errors/mandates#library_changed) — The probe library has changed since that campaign, so its probes cannot be run again as they were.
- [`already_imported`](https://www.azothos.ai/docs/errors/mandates#already_imported) — This file was already imported for this system.
- [`not_json`](https://www.azothos.ai/docs/errors/mandates#not_json) — The results file is not JSON.
- [`unrecognised_format`](https://www.azothos.ai/docs/errors/mandates#unrecognised_format) — The file is neither a Giskard scan (to_json) nor the azoth.redteam.import/1 format.
- [`invalid_results`](https://www.azothos.ai/docs/errors/mandates#invalid_results) — The file’s results do not match their format: the answer’s error says where.
- [`ran_in_future`](https://www.azothos.ai/docs/errors/mandates#ran_in_future) — The file says its run happened in the future.
- [`agent_not_archived`](https://www.azothos.ai/docs/errors/mandates#agent_not_archived) — This agent is not archived, so there is nothing to unarchive.

## Budgets, plan limits and public systems

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/limits)

- [`budget_exceeded`](https://www.azothos.ai/docs/errors/limits#budget_exceeded) — This call was blocked before any spend: a budget is used up.
- [`budget_unavailable`](https://www.azothos.ai/docs/errors/limits#budget_unavailable) — This call was blocked: the budget check could not run.
- [`ai_ops_limit_exceeded`](https://www.azothos.ai/docs/errors/limits#ai_ops_limit_exceeded) — This call was blocked: the plan’s monthly AI operations are used up.
- [`sealed_decisions_limit_reached`](https://www.azothos.ai/docs/errors/limits#sealed_decisions_limit_reached) — This call was blocked: the plan’s sealed decisions for this month are used up, and the grace period has ended.
- [`governed_system_limit_reached`](https://www.azothos.ai/docs/errors/limits#governed_system_limit_reached) — Every governed system your plan allows is in use, so a new one cannot start.
- [`billing_cancel_failed`](https://www.azothos.ai/docs/errors/limits#billing_cancel_failed) — A workspace is deleted, or erased with its owner’s account, only once its subscription is cancelled. That cancellation failed, so nothing was deleted.
- [`subscription_exists`](https://www.azothos.ai/docs/errors/limits#subscription_exists) — A workspace has one subscription at a time. This one already has one that bills, or can bill again once its payment is settled, so a second checkout is not opened.
- [`plan_required`](https://www.azothos.ai/docs/errors/limits#plan_required) — This feature runs on this deployment, but the workspace’s plan does not include it.
- [`regression_suite_limit_exceeded`](https://www.azothos.ai/docs/errors/limits#regression_suite_limit_exceeded) — The workspace has as many regression suites as its plan allows, so a new one cannot be created.
- [`exhaustion_slow`](https://www.azothos.ai/docs/errors/limits#exhaustion_slow) — This call was slowed down: this visitor sends too many requests.
- [`exhaustion_challenge_required`](https://www.azothos.ai/docs/errors/limits#exhaustion_challenge_required) — This call waits for a check: the system sees unusual volume.
- [`exhaustion_blocked`](https://www.azothos.ai/docs/errors/limits#exhaustion_blocked) — This call was blocked: unusual volume on a public system.
- [`exposure_unavailable`](https://www.azothos.ai/docs/errors/limits#exposure_unavailable) — Exposing a system to the public is not available on this deployment yet.
- [`exhaustion_incident_not_found`](https://www.azothos.ai/docs/errors/limits#exhaustion_incident_not_found) — This exhaustion incident does not exist in this workspace.
- [`own_ai_busy`](https://www.azothos.ai/docs/errors/limits#own_ai_busy) — Azoth’s own AI is paused for now.
- [`ingest_queue_full`](https://www.azothos.ai/docs/errors/limits#ingest_queue_full) — Azoth’s ingest queue is full: the batch was not accepted, and nothing was stored.
- [`workspace_limit_reached`](https://www.azothos.ai/docs/errors/limits#workspace_limit_reached) — You own as many workspaces as your plan allows, so this one was not created.
- [`agent_limit_exceeded`](https://www.azothos.ai/docs/errors/limits#agent_limit_exceeded) — Every agent your plan allows is in use, so this one was not created.
- [`workflow_limit_exceeded`](https://www.azothos.ai/docs/errors/limits#workflow_limit_exceeded) — Every workflow your plan allows is in use, so this one was not created.
- [`connector_limit_reached`](https://www.azothos.ai/docs/errors/limits#connector_limit_reached) — Every connector your plan allows is in use, so this one was not added.
- [`simulation_quota_exceeded`](https://www.azothos.ai/docs/errors/limits#simulation_quota_exceeded) — The simulations your plan allows this month are used up.
- [`plan_feature_required`](https://www.azothos.ai/docs/errors/limits#plan_feature_required) — Single sign-on is part of the Growth and Enterprise plans.
- [`audit_export_not_entitled`](https://www.azothos.ai/docs/errors/limits#audit_export_not_entitled) — The continuous audit export is not included in this workspace’s plan.
- [`sovereign_routing_required`](https://www.azothos.ai/docs/errors/limits#sovereign_routing_required) — Sovereignty insights are not included in this workspace’s plan.
- [`plan_insufficient`](https://www.azothos.ai/docs/errors/limits#plan_insufficient) — Inventory Object ingestion is not included in the Free plan.
- [`checkout_required`](https://www.azothos.ai/docs/errors/limits#checkout_required) — The Growth trial starts at checkout, with a payment method — not from here.
- [`no_trial`](https://www.azothos.ai/docs/errors/limits#no_trial) — No trial is waiting for this workspace.
- [`annual_price_unavailable`](https://www.azothos.ai/docs/errors/limits#annual_price_unavailable) — Yearly billing is not offered for this plan, so no checkout was opened.
- [`not_in_deployment`](https://www.azothos.ai/docs/errors/limits#not_in_deployment) — Billing is not part of this deployment: this address receives nothing.
- [`entitlement_unavailable`](https://www.azothos.ai/docs/errors/limits#entitlement_unavailable) — The plan’s limits could not be read, so nothing was started.
- [`simulation_access_unavailable`](https://www.azothos.ai/docs/errors/limits#simulation_access_unavailable) — Access to simulations could not be checked, so none was run.
- [`mandate_spend_unavailable`](https://www.azothos.ai/docs/errors/limits#mandate_spend_unavailable) — Spend per mandate is not available on this deployment yet.
- [`month_cap`](https://www.azothos.ai/docs/errors/limits#month_cap) — This campaign’s cap would take the workspace past its monthly red-teaming cap, so it was not started.
- [`billing_managed_by_sales`](https://www.azothos.ai/docs/errors/limits#billing_managed_by_sales) — This workspace’s plan is billed under a contract with Azoth, not through the online checkout.
- [`billing_account_missing`](https://www.azothos.ai/docs/errors/limits#billing_account_missing) — This workspace has no billing account yet, so there is no billing portal to open.
- [`entry_limit_reached`](https://www.azothos.ai/docs/errors/limits#entry_limit_reached) — This list holds as many entries as it can, so the new one was not added.

## The applicable law and retention

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/law)

- [`zone_invalid`](https://www.azothos.ai/docs/errors/law#zone_invalid) — A zone is not a code Azoth knows.
- [`sector_invalid`](https://www.azothos.ai/docs/errors/law#sector_invalid) — A sector is not one of the list.
- [`provider_invalid`](https://www.azothos.ai/docs/errors/law#provider_invalid) — A provider name is not valid.
- [`mechanism_unknown`](https://www.azothos.ai/docs/errors/law#mechanism_unknown) — A transfer safeguard is not one the laws covered here recognise.
- [`pack_unknown`](https://www.azothos.ai/docs/errors/law#pack_unknown) — A law or a standard to apply is not in the list Azoth ships.
- [`jurisdiction_unavailable`](https://www.azothos.ai/docs/errors/law#jurisdiction_unavailable) — The applicable law is not set up on this deployment yet.
- [`jurisdiction_write_failed`](https://www.azothos.ai/docs/errors/law#jurisdiction_write_failed) — The applicable-law settings could not be saved.
- [`justification_too_short`](https://www.azothos.ai/docs/errors/law#justification_too_short) — The justification is too short to be kept with the decision.
- [`override_duration_invalid`](https://www.azothos.ai/docs/errors/law#override_duration_invalid) — A reading of the law lasts from 1 to 365 days.
- [`rule_unknown`](https://www.azothos.ai/docs/errors/law#rule_unknown) — The rule named is in no law pack Azoth knows.
- [`effect_invalid`](https://www.azothos.ai/docs/errors/law#effect_invalid) — The way the rule is applied is not one of the choices.
- [`override_not_found`](https://www.azothos.ai/docs/errors/law#override_not_found) — That reading of the law no longer exists.
- [`evidence_invalid`](https://www.azothos.ai/docs/errors/law#evidence_invalid) — An evidence date of the mandate is not valid.
- [`retention_below_floor`](https://www.azothos.ai/docs/errors/law#retention_below_floor) — This retention window is shorter than the law that applies to the workspace asks for.
- [`eu_storage_unavailable`](https://www.azothos.ai/docs/errors/law#eu_storage_unavailable) — The workspace’s data policy requires EU-only storage for this data, and this deployment cannot guarantee it: the batch was refused and nothing was stored.
- [`change_not_found`](https://www.azothos.ai/docs/errors/law#change_not_found) — This regulatory change is not waiting for a review.
- [`data_policy_violation`](https://www.azothos.ai/docs/errors/law#data_policy_violation) — The workspace’s data policy refused this batch, so nothing was stored.

## Waivers and options of a refusal

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/waivers)

- [`not_rule_owner`](https://www.azothos.ai/docs/errors/waivers#not_rule_owner) — Only the owner of the rule, or an owner or admin of the workspace, decides a waiver of this rule.
- [`four_eyes`](https://www.azothos.ai/docs/errors/waivers#four_eyes) — The person who asked for a waiver cannot decide it.
- [`decision_reason_required`](https://www.azothos.ai/docs/errors/waivers#decision_reason_required) — A decision on a request was sent without its reason.
- [`requester_unknown`](https://www.azothos.ai/docs/errors/waivers#requester_unknown) — A request made through an API key can be rejected but not approved: nobody knows which person stands behind the key, so four eyes cannot be established.
- [`request_lapsed`](https://www.azothos.ai/docs/errors/waivers#request_lapsed) — The waiver request was not decided within 7 days, so it lapsed.
- [`not_active`](https://www.azothos.ai/docs/errors/waivers#not_active) — This waiver is not in force.
- [`already_decided`](https://www.azothos.ai/docs/errors/waivers#already_decided) — Someone decided this request a moment ago.
- [`already_approved`](https://www.azothos.ai/docs/errors/waivers#already_approved) — This request is already approved.
- [`already_denied`](https://www.azothos.ai/docs/errors/waivers#already_denied) — This request was already denied.
- [`already_revoked`](https://www.azothos.ai/docs/errors/waivers#already_revoked) — This waiver was already revoked.
- [`duration_exceeds_ceiling`](https://www.azothos.ai/docs/errors/waivers#duration_exceeds_ceiling) — The duration asked is longer than the workspace allows for a waiver.
- [`not_exceptionable`](https://www.azothos.ai/docs/errors/waivers#not_exceptionable) — No waiver can lift this refusal.
- [`no_identity`](https://www.azothos.ai/docs/errors/waivers#no_identity) — The refusal names no API key, agent or system that a waiver could cover.
- [`invalid_refusal_ref`](https://www.azothos.ai/docs/errors/waivers#invalid_refusal_ref) — The refusal reference sent cannot be used.
- [`rule_not_found`](https://www.azothos.ai/docs/errors/waivers#rule_not_found) — This rule no longer exists.
- [`owner_not_a_member`](https://www.azothos.ai/docs/errors/waivers#owner_not_a_member) — The owner named — of a rule, an agent or an MCP server — must be a member of the workspace.
- [`invalid_alternative`](https://www.azothos.ai/docs/errors/waivers#invalid_alternative) — The option sent in `X-Azoth-Alternative` is not one Azoth offers.
- [`alternative_not_offered`](https://www.azothos.ai/docs/errors/waivers#alternative_not_offered) — This refusal did not offer that option.
- [`alternative_mismatch`](https://www.azothos.ai/docs/errors/waivers#alternative_mismatch) — The call sent with the EU-hosted model option does not go to a provider hosted in the EU.

## Proof: holds, dossiers and timestamps

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/proof)

- [`subject_erasure_unavailable`](https://www.azothos.ai/docs/errors/proof#subject_erasure_unavailable) — The tool that erases a person's data is not ready on this deployment.
- [`legal_hold_active`](https://www.azothos.ai/docs/errors/proof#legal_hold_active) — A litigation hold preserves this evidence: it cannot be deleted while the hold is active.
- [`entries_not_found`](https://www.azothos.ai/docs/errors/proof#entries_not_found) — Some of the decisions designated are not in the journal of this workspace.
- [`decision_not_found`](https://www.azothos.ai/docs/errors/proof#decision_not_found) — No sealed decision carries this reference.
- [`too_many_entries`](https://www.azothos.ai/docs/errors/proof#too_many_entries) — A hold designates 500 decisions at most.
- [`invalid_decision_ref`](https://www.azothos.ai/docs/errors/proof#invalid_decision_ref) — The decision reference is not in a form Azoth accepts.
- [`hold_not_found`](https://www.azothos.ai/docs/errors/proof#hold_not_found) — This litigation hold no longer exists.
- [`hold_released`](https://www.azothos.ai/docs/errors/proof#hold_released) — This hold is released already.
- [`release_pending`](https://www.azothos.ai/docs/errors/proof#release_pending) — A release of this hold is already waiting for a decision.
- [`legal_holds_unavailable`](https://www.azothos.ai/docs/errors/proof#legal_holds_unavailable) — Litigation holds are not available on this deployment yet.
- [`period_invalid`](https://www.azothos.ai/docs/errors/proof#period_invalid) — The period asked is not valid.
- [`timestamp_level_unavailable`](https://www.azothos.ai/docs/errors/proof#timestamp_level_unavailable) — This deployment cannot timestamp at the level chosen.
- [`dossier_signature_unavailable`](https://www.azothos.ai/docs/errors/proof#dossier_signature_unavailable) — The dossier was not exported: Azoth could not sign it with the workspace’s key, and it never hands over an unsigned dossier — nothing would bind its content to the workspace, so entries could be removed from it unnoticed.
- [`tsa_chain_required`](https://www.azothos.ai/docs/errors/proof#tsa_chain_required) — A timestamp authority is saved only with its root certificates.
- [`tsa_url_invalid`](https://www.azothos.ai/docs/errors/proof#tsa_url_invalid) — The address of the authority is refused.
- [`tsa_check_timeout`](https://www.azothos.ai/docs/errors/proof#tsa_check_timeout) — The authority did not answer the test request of Azoth in time.
- [`tsa_check_unreachable`](https://www.azothos.ai/docs/errors/proof#tsa_check_unreachable) — Azoth could not reach the authority.
- [`tsa_check_http_error`](https://www.azothos.ai/docs/errors/proof#tsa_check_http_error) — The authority answered the test request with an HTTP error.
- [`tsa_check_refused`](https://www.azothos.ai/docs/errors/proof#tsa_check_refused) — The authority refused to timestamp the test request.
- [`tsa_check_invalid_token`](https://www.azothos.ai/docs/errors/proof#tsa_check_invalid_token) — The authority answered, but its token does not chain to the root certificates given.
- [`tsa_check_failed`](https://www.azothos.ai/docs/errors/proof#tsa_check_failed) — The authority could not be checked.
- [`footprint_not_read`](https://www.azothos.ai/docs/errors/proof#footprint_not_read) — A repository’s AI footprint is attested only once it is turned on and read in full.
- [`ai_footprint_statement_not_found`](https://www.azothos.ai/docs/errors/proof#ai_footprint_statement_not_found) — No sealed AI footprint statement of this workspace has this id.
- [`unknown_framework`](https://www.azothos.ai/docs/errors/proof#unknown_framework) — No compliance framework has this id.
- [`unknown_requirement`](https://www.azothos.ai/docs/errors/proof#unknown_requirement) — This framework has no requirement with this id.
- [`already_declared`](https://www.azothos.ai/docs/errors/proof#already_declared) — This requirement is already declared out of scope.

## Incident mode

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/incidents)

- [`incident_not_found`](https://www.azothos.ai/docs/errors/incidents#incident_not_found) — This incident does not exist in this workspace.
- [`incident_closed`](https://www.azothos.ai/docs/errors/incidents#incident_closed) — This incident is closed and takes no more actions.
- [`related_incident_not_found`](https://www.azothos.ai/docs/errors/incidents#related_incident_not_found) — The related incident named does not exist in this workspace.
- [`scope_not_enforceable`](https://www.azothos.ai/docs/errors/incidents#scope_not_enforceable) — The scope of the incident names nothing the gateway can block.
- [`provider_not_found`](https://www.azothos.ai/docs/errors/incidents#provider_not_found) — No connected provider of this workspace has this id.
- [`containment_not_found`](https://www.azothos.ai/docs/errors/incidents#containment_not_found) — This containment does not exist for the incident.
- [`containment_lifted`](https://www.azothos.ai/docs/errors/incidents#containment_lifted) — This containment was lifted already.
- [`already_reviewed`](https://www.azothos.ai/docs/errors/incidents#already_reviewed) — This decision already has a verdict, and verdicts are final.
- [`decision_not_in_incident`](https://www.azothos.ai/docs/errors/incidents#decision_not_in_incident) — This decision is not among those the incident touched.
- [`not_a_reviewer`](https://www.azothos.ai/docs/errors/incidents#not_a_reviewer) — Reviewing the decisions of an incident is for owners, admins and members.
- [`draft_not_found`](https://www.azothos.ai/docs/errors/incidents#draft_not_found) — This report draft does not exist.
- [`incident_containment`](https://www.azothos.ai/docs/errors/incidents#incident_containment) — This rule contains an incident: it is lifted with the incident, never by a waiver.

## Model changes and the portfolio

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/models)

- [`reference_set_not_found`](https://www.azothos.ai/docs/errors/models#reference_set_not_found) — This mandate has no reference set yet.
- [`run_not_found`](https://www.azothos.ai/docs/errors/models#run_not_found) — This comparison run does not exist in this workspace.
- [`report_not_found`](https://www.azothos.ai/docs/errors/models#report_not_found) — This comparison run has no report.
- [`not_a_candidate_run`](https://www.azothos.ai/docs/errors/models#not_a_candidate_run) — Only a comparison run of a new model version can be acted on.
- [`nothing_to_pin`](https://www.azothos.ai/docs/errors/models#nothing_to_pin) — There is no other version to route the calls to.
- [`unknown_case`](https://www.azothos.ai/docs/errors/models#unknown_case) — A case of the client receipt is not in the reference set, or its hash differs.
- [`duplicate_case`](https://www.azothos.ai/docs/errors/models#duplicate_case) — The client receipt names a case twice.
- [`incomplete_receipt`](https://www.azothos.ai/docs/errors/models#incomplete_receipt) — The client receipt does not cover every case of the reference set.
- [`run_not_awaiting_client`](https://www.azothos.ai/docs/errors/models#run_not_awaiting_client) — This comparison run is not waiting for a client receipt.
- [`month_in_future`](https://www.azothos.ai/docs/errors/models#month_in_future) — The month asked has not started yet.
- [`alternative_not_priced`](https://www.azothos.ai/docs/errors/models#alternative_not_priced) — The alternative model has no price, or is the model already in service, so no comparison was queued.
- [`catalog_version_invalid`](https://www.azothos.ai/docs/errors/models#catalog_version_invalid) — A version of the model catalogue is a number, or latest.
- [`catalog_version_not_found`](https://www.azothos.ai/docs/errors/models#catalog_version_not_found) — No published version of the model catalogue has this number.

## Any request: validation and server failures

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/requests)

- [`validation_failed`](https://www.azothos.ai/docs/errors/requests#validation_failed) — The request’s body or parameters do not match what the route accepts, so nothing was done. The answer’s `error` describes the problem and `field` names the field, when there is one.
- [`internal_error`](https://www.azothos.ai/docs/errors/requests#internal_error) — The request failed on Azoth’s side, for a reason the answer does not give: nothing in the request was at fault. The failure is recorded for Azoth’s team.
- [`not_found`](https://www.azothos.ai/docs/errors/requests#not_found) — Nothing the request names exists in this workspace — or it exists, but this caller may not read it.
- [`service_unavailable`](https://www.azothos.ai/docs/errors/requests#service_unavailable) — Azoth could not reach its database, so nothing was done and nothing was recorded.
- [`unknown_tool`](https://www.azothos.ai/docs/errors/requests#unknown_tool) — No insight tool has this name. The answer’s `tools` lists the names that exist.
- [`not_configured`](https://www.azothos.ai/docs/errors/requests#not_configured) — This deployment lacks a setting the request needs — a secret, a vendor’s account or keys — so nothing was done. Trying again changes nothing until it is set.
- [`migration_missing`](https://www.azothos.ai/docs/errors/requests#migration_missing) — This feature needs a database update that is not applied yet, so nothing was done.
- [`replay_unavailable`](https://www.azothos.ai/docs/errors/requests#replay_unavailable) — A request cannot be sent again by Azoth: Azoth keeps a hash of each prompt, never the prompt itself.
- [`action_not_offered`](https://www.azothos.ai/docs/errors/requests#action_not_offered) — This action is not offered for this item of the queue.
- [`item_not_waiting`](https://www.azothos.ai/docs/errors/requests#item_not_waiting) — This item no longer waits in the queue.
- [`not_allowed`](https://www.azothos.ai/docs/errors/requests#not_allowed) — You may not act on this item of the queue.
- [`delegate_to_self`](https://www.azothos.ai/docs/errors/requests#delegate_to_self) — An item is not delegated to yourself.
- [`delegate_not_allowed`](https://www.azothos.ai/docs/errors/requests#delegate_not_allowed) — The member chosen may not act on this item, so it cannot be delegated to them.
- [`worker_secret_invalid`](https://www.azothos.ai/docs/errors/requests#worker_secret_invalid) — A scheduled job or an internal route of the deployment was called without its secret, so nothing ran.
- [`already_exists`](https://www.azothos.ai/docs/errors/requests#already_exists) — What the request would add exists already: the name, address or value it gives is taken, so nothing was added.
- [`operation_in_progress`](https://www.azothos.ai/docs/errors/requests#operation_in_progress) — The same operation is already running for this workspace, so this request did nothing.
- [`method_not_allowed`](https://www.azothos.ai/docs/errors/requests#method_not_allowed) — The route does not take this HTTP method; the answer’s `Allow` header names the one it takes.
- [`integration_not_connected`](https://www.azothos.ai/docs/errors/requests#integration_not_connected) — The integration this action needs — GitHub, Slack, Microsoft Teams, single sign-on or a model endpoint — is not set up for this workspace.
- [`integration_failed`](https://www.azothos.ai/docs/errors/requests#integration_failed) — The service of an integration — GitHub, Slack, Microsoft Teams — refused or failed the request Azoth sent it, so nothing was done. The answer gives its HTTP status (`vendorStatus`) and its own error code (`vendorCode`), never its text.

## Support: tickets and access

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/support)

- [`ticket_contains_secret`](https://www.azothos.ai/docs/errors/support#ticket_contains_secret) — The message holds what looks like a secret — an API key, a password, a token — so it was not sent.
- [`transcript_contains_secret`](https://www.azothos.ai/docs/errors/support#transcript_contains_secret) — The assistant conversation joined to the ticket holds what looks like a secret, so the ticket was not created.
- [`ticket_closed`](https://www.azothos.ai/docs/errors/support#ticket_closed) — This ticket is closed: it takes no more replies.
- [`ticket_not_resolved`](https://www.azothos.ai/docs/errors/support#ticket_not_resolved) — Only a ticket marked resolved asks whether it was solved.
- [`cause_required`](https://www.azothos.ai/docs/errors/support#cause_required) — A ticket is resolved or closed only with its cause.
- [`critical_requires_incident`](https://www.azothos.ai/docs/errors/support#critical_requires_incident) — Only an incident ticket can be critical.
- [`support_unavailable`](https://www.azothos.ai/docs/errors/support#support_unavailable) — The support data could not be read, so nothing was done.
- [`support_access_saas_only`](https://www.azothos.ai/docs/errors/support#support_access_saas_only) — Access by Azoth’s support exists only on Azoth’s service: a deployment of your own has none.
- [`support_access_open`](https://www.azothos.ai/docs/errors/support#support_access_open) — A support access to this workspace is already waiting for a decision, or open.
- [`support_access_unsealed`](https://www.azothos.ai/docs/errors/support#support_access_unsealed) — The support access could not be sealed in the journals, so it was refused: no access goes unrecorded.
- [`grant_not_pending`](https://www.azothos.ai/docs/errors/support#grant_not_pending) — This request for support access was decided already.
- [`grant_not_active`](https://www.azothos.ai/docs/errors/support#grant_not_active) — This support access is no longer open.
- [`emergency_requires_enterprise`](https://www.azothos.ai/docs/errors/support#emergency_requires_enterprise) — Emergency access by Azoth’s support is part of the Enterprise plan.
- [`emergency_not_consented`](https://www.azothos.ai/docs/errors/support#emergency_not_consented) — The workspace’s owners have not agreed to emergency access, so none can be opened.
- [`emergency_requires_critical`](https://www.azothos.ai/docs/errors/support#emergency_requires_critical) — Emergency access is opened only for a critical ticket.
- [`second_staff_required`](https://www.azothos.ai/docs/errors/support#second_staff_required) — An emergency access is confirmed by a second member of Azoth’s staff, never by the one who asked for it.

## Single sign-on, chat apps and connectors

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/integrations)

- [`sso_oidc_unavailable`](https://www.azothos.ai/docs/errors/integrations#sso_oidc_unavailable) — The identity provider of this address could not be reached, so single sign-on could not start or complete.
- [`sso_domain_unverified`](https://www.azothos.ai/docs/errors/integrations#sso_domain_unverified) — Single sign-on cannot be required for a domain the workspace has not verified it owns.
- [`sso_provider_required`](https://www.azothos.ai/docs/errors/integrations#sso_provider_required) — Single sign-on cannot be required while no identity provider is enabled for the workspace.
- [`sso_type_change`](https://www.azothos.ai/docs/errors/integrations#sso_type_change) — This workspace already has a SAML identity provider: an OIDC provider cannot be saved beside it.
- [`oidc_client_secret_required`](https://www.azothos.ai/docs/errors/integrations#oidc_client_secret_required) — An OIDC identity provider is saved with its client secret.
- [`oidc_issuer_invalid`](https://www.azothos.ai/docs/errors/integrations#oidc_issuer_invalid) — The issuer is not a public https address an identity provider can use, so the provider was not saved.
- [`oidc_issuer_multi_tenant`](https://www.azothos.ai/docs/errors/integrations#oidc_issuer_multi_tenant) — This issuer serves many organisations, so it cannot sign in the members of one workspace.
- [`oidc_discovery_failed`](https://www.azothos.ai/docs/errors/integrations#oidc_discovery_failed) — The identity provider’s discovery document could not be read, so the provider was not saved.
- [`oidc_discovery_mismatch`](https://www.azothos.ai/docs/errors/integrations#oidc_discovery_mismatch) — The identity provider’s discovery document names another issuer, or lacks an endpoint, so the provider was not saved.
- [`sso_too_many_attempts`](https://www.azothos.ai/docs/errors/integrations#sso_too_many_attempts) — Too many single sign-on returns came from this network address in a minute, so this one was not completed.
- [`sso_attempt_expired`](https://www.azothos.ai/docs/errors/integrations#sso_attempt_expired) — The sign-in that came back from the identity provider is not one this browser started, or it took too long, so no session was opened.
- [`sso_idp_refused`](https://www.azothos.ai/docs/errors/integrations#sso_idp_refused) — The identity provider came back without signing the person in, so no session was opened.
- [`sso_provider_unavailable`](https://www.azothos.ai/docs/errors/integrations#sso_provider_unavailable) — The workspace’s single sign-on is not available any more, so the sign-in could not be completed.
- [`sso_provider_misconfigured`](https://www.azothos.ai/docs/errors/integrations#sso_provider_misconfigured) — The workspace’s identity provider settings cannot be used to sign in, so no session was opened.
- [`sso_token_exchange_failed`](https://www.azothos.ai/docs/errors/integrations#sso_token_exchange_failed) — The identity provider refused to complete the sign-in for Azoth, so no session was opened.
- [`sso_id_token_invalid`](https://www.azothos.ai/docs/errors/integrations#sso_id_token_invalid) — The identity the provider sent could not be verified, so no session was opened.
- [`sso_email_domain_mismatch`](https://www.azothos.ai/docs/errors/integrations#sso_email_domain_mismatch) — The identity provider signed the person in with an e-mail address outside the workspace’s verified domain, or with none, so no session was opened.
- [`sso_email_unverified`](https://www.azothos.ai/docs/errors/integrations#sso_email_unverified) — The identity provider did not confirm it verified the e-mail address, so no session was opened.
- [`dns_lookup_failed`](https://www.azothos.ai/docs/errors/integrations#dns_lookup_failed) — The domain’s DNS could not be read, so its ownership could not be checked.
- [`record_not_found`](https://www.azothos.ai/docs/errors/integrations#record_not_found) — The TXT record that proves the domain was not found in its DNS.
- [`domain_already_verified`](https://www.azothos.ai/docs/errors/integrations#domain_already_verified) — Another Azoth workspace has already verified this domain: one domain signs in to one workspace.
- [`domain_changed`](https://www.azothos.ai/docs/errors/integrations#domain_changed) — The single sign-on domain changed while it was being verified, so nothing was recorded.
- [`sso_provider_update_failed`](https://www.azothos.ai/docs/errors/integrations#sso_provider_update_failed) — The domain is verified, but registering it with the sign-in service failed.
- [`sso_provider_delete_failed`](https://www.azothos.ai/docs/errors/integrations#sso_provider_delete_failed) — The sign-in service did not remove the workspace’s SAML identity provider, so Azoth removed nothing either: single sign-on stays as it was.
- [`link_expired`](https://www.azothos.ai/docs/errors/integrations#link_expired) — This link to connect your chat account has expired.
- [`not_installed`](https://www.azothos.ai/docs/errors/integrations#not_installed) — This Slack workspace or Teams bot is not connected to Azoth.
- [`chat_identity_mismatch`](https://www.azothos.ai/docs/errors/integrations#chat_identity_mismatch) — This chat account is not yours: the e-mail its platform holds for it is not the e-mail of your Azoth account, so nothing was linked.
- [`chat_identity_unverified`](https://www.azothos.ai/docs/errors/integrations#chat_identity_unverified) — The chat platform does not give this account’s e-mail, so Azoth cannot tell whose it is: nothing was linked.
- [`chat_identity_unavailable`](https://www.azothos.ai/docs/errors/integrations#chat_identity_unavailable) — The chat platform could not say whose account this is, so nothing was linked.
- [`teams_secret_required`](https://www.azothos.ai/docs/errors/integrations#teams_secret_required) — A Teams bot is saved with its client secret.
- [`teams_credentials_invalid`](https://www.azothos.ai/docs/errors/integrations#teams_credentials_invalid) — Microsoft refused these credentials, so the bot was not saved.
- [`teams_app_taken`](https://www.azothos.ai/docs/errors/integrations#teams_app_taken) — This Teams bot is already connected to another Azoth workspace.
- [`connector_not_available`](https://www.azothos.ai/docs/errors/integrations#connector_not_available) — Connecting an assistant (Claude, ChatGPT) is not included in this workspace’s plan.
- [`connectors_disabled`](https://www.azothos.ai/docs/errors/integrations#connectors_disabled) — The workspace’s owners or admins turned connected assistants off.
- [`missing_token`](https://www.azothos.ai/docs/errors/integrations#missing_token) — The connector endpoint was called without an access token.
- [`invalid_token`](https://www.azothos.ai/docs/errors/integrations#invalid_token) — The connector endpoint was called with an access token it does not accept: expired, revoked, malformed or issued for another address.
- [`insufficient_scope`](https://www.azothos.ai/docs/errors/integrations#insufficient_scope) — The access token does not carry the read access the connector needs.
- [`missing_client`](https://www.azothos.ai/docs/errors/integrations#missing_client) — The connection request names no client, so the assistant cannot be connected.
- [`unknown_client`](https://www.azothos.ai/docs/errors/integrations#unknown_client) — The connection request names an assistant Azoth does not know.
- [`invalid_redirect_uri`](https://www.azothos.ai/docs/errors/integrations#invalid_redirect_uri) — The connection request’s return address is not one the assistant declared, so Azoth will not send it there.
- [`connector_not_installed`](https://www.azothos.ai/docs/errors/integrations#connector_not_installed) — The Inventory Object connector is not installed for this workspace and environment, so nothing was stored.
- [`connector_revoked`](https://www.azothos.ai/docs/errors/integrations#connector_revoked) — This connector was uninstalled, so it cannot be approved: an uninstall is never turned back on.
- [`connector_governance_failed`](https://www.azothos.ai/docs/errors/integrations#connector_governance_failed) — The connector’s governance check failed during the test ingestion, so the test row was not stored.
- [`repository_not_found`](https://www.azothos.ai/docs/errors/integrations#repository_not_found) — No repository of this workspace’s GitHub connection has this id.

## Azoth’s team tools

[Every entry of this family, in full](https://www.azothos.ai/docs/errors/staff)

- [`platform_admin_required`](https://www.azothos.ai/docs/errors/staff#platform_admin_required) — This tool is for Azoth’s team only.
- [`staff_mfa_required`](https://www.azothos.ai/docs/errors/staff#staff_mfa_required) — Azoth’s staff reach these tools only with two-factor authentication on the session.
- [`staff_access_unsealed`](https://www.azothos.ai/docs/errors/staff#staff_access_unsealed) — The staff access could not be sealed in the platform journal, so it was refused: no staff access goes unrecorded.
- [`override_expired`](https://www.azothos.ai/docs/errors/staff#override_expired) — This contract override has ended: limits saved on it would not apply.
- [`report_altered`](https://www.azothos.ai/docs/errors/staff#report_altered) — The drill report does not match its sha256, so it was not recorded.
- [`catalog_not_here`](https://www.azothos.ai/docs/errors/staff#catalog_not_here) — The model catalogue is edited on Azoth’s service only; a deployment of your own imports it, signed, and Azoth’s service imports none.
- [`catalog_check_required`](https://www.azothos.ai/docs/errors/staff#catalog_check_required) — A catalogue entry is added only once it was checked against its source, today.
- [`catalog_source_required`](https://www.azothos.ai/docs/errors/staff#catalog_source_required) — A checked price names its source.
- [`catalog_draft_too_large`](https://www.azothos.ai/docs/errors/staff#catalog_draft_too_large) — The draft file is larger than a draft may be.
- [`catalog_no_draft`](https://www.azothos.ai/docs/errors/staff#catalog_no_draft) — No catalogue draft is open.
- [`catalog_draft_changed`](https://www.azothos.ai/docs/errors/staff#catalog_draft_changed) — The draft changed after it was reviewed, so it was not published.
- [`catalog_empty`](https://www.azothos.ai/docs/errors/staff#catalog_empty) — An empty catalogue is never published.
- [`catalog_no_version`](https://www.azothos.ai/docs/errors/staff#catalog_no_version) — No version of the catalogue is in force to compare the draft with.
- [`catalog_import_concurrent`](https://www.azothos.ai/docs/errors/staff#catalog_import_concurrent) — Another import of these proposals ran at the same time.
- [`catalog_proposal_not_open`](https://www.azothos.ai/docs/errors/staff#catalog_proposal_not_open) — This proposal is no longer open.
- [`catalog_proposal_no_entry`](https://www.azothos.ai/docs/errors/staff#catalog_proposal_no_entry) — This proposal holds no entry to add.
- [`catalog_signature_invalid`](https://www.azothos.ai/docs/errors/staff#catalog_signature_invalid) — The catalogue’s signature does not verify with the keys this deployment pins, so nothing was imported.
- [`catalog_hash_mismatch`](https://www.azothos.ai/docs/errors/staff#catalog_hash_mismatch) — A stored version of the catalogue does not hash to its recorded sha256, so it is neither served nor signed.
- [`catalog_already_signed`](https://www.azothos.ai/docs/errors/staff#catalog_already_signed) — This version of the catalogue is already signed: a signature is added once.
- [`catalog_version_conflict`](https://www.azothos.ai/docs/errors/staff#catalog_version_conflict) — This deployment holds another version under that number, so the import was refused.
- [`breach_no_recipient`](https://www.azothos.ai/docs/errors/staff#breach_no_recipient) — The workspaces named have no owner or admin to notify, so nothing was sent.
- [`breach_notice_conflict`](https://www.azothos.ai/docs/errors/staff#breach_notice_conflict) — This notice number was already sent with other texts.
- [`breach_recipients_truncated`](https://www.azothos.ai/docs/errors/staff#breach_recipients_truncated) — Too many memberships to read at once, so nothing was sent.
- [`breach_workspace_not_found`](https://www.azothos.ai/docs/errors/staff#breach_workspace_not_found) — A workspace named does not exist, so nothing was sent.
- [`breach_workspaces_not_one_customer`](https://www.azothos.ai/docs/errors/staff#breach_workspaces_not_one_customer) — One notice concerns one customer: the workspaces named belong to several.
- [`subprocessor_notice_conflict`](https://www.azothos.ai/docs/errors/staff#subprocessor_notice_conflict) — This version was already announced with another content.
- [`subprocessor_notice_saas_only`](https://www.azothos.ai/docs/errors/staff#subprocessor_notice_saas_only) — Outside Azoth’s service, the deployment’s operator informs its own customers.
- [`subprocessor_notice_unsealed`](https://www.azothos.ai/docs/errors/staff#subprocessor_notice_unsealed) — The announcement could not be sealed, so nothing was sent.
- [`subprocessor_recipients_truncated`](https://www.azothos.ai/docs/errors/staff#subprocessor_recipients_truncated) — Too many memberships to read at once, so nothing was sent.
