Error codes

388 REST/HTTP error codes, generated at build time from src/errors/codes.tsand src/errors/factory.ts. Each code's docs_url resolves to/errors/{code} here.

MCP transport-local failures carried in JSON-RPC error.data.chorus_code are protocol codes, not HTTP status codes, and are documented in thetransport reference.

Code	HTTP
A2A_CANCEL_FAILED	500
A2A_SIGNAL_TYPE_REQUIRED	400
A2A_TASK_UNAUTHORIZED	403
ACTION_FINGERPRINT_MISMATCH	403
API_KEY_NOT_FOUND	404
API_KEY_VALIDATION_FAILED	400
APPROVAL_ACTION_INTEGRITY_FAILED	500
APPROVAL_CANCEL_FORBIDDEN	403
APPROVAL_DUPLICATE_VOTE	409
APPROVAL_EXECUTION_ATTEMPT_CONFLICT	409
APPROVAL_EXECUTION_ATTEMPT_NOT_FOUND	404
APPROVAL_EXECUTION_BINDING_REQUIRED	403
APPROVAL_EXECUTION_COMPLETED	409
APPROVAL_EXECUTION_IN_FLIGHT	409
APPROVAL_EXECUTION_LEASE_EXPIRED	409
APPROVAL_EXECUTION_OUTCOME_CONFLICT	409
APPROVAL_EXECUTION_REVISION_CONFLICT	409
APPROVAL_EXECUTOR_FORBIDDEN	403
APPROVAL_GATE_ID_INVALID	400
APPROVAL_GATE_ID_REQUIRED	403
APPROVAL_GATE_NOT_FOUND	404
APPROVAL_GATE_TERMINAL	422
APPROVAL_GATE_VALIDATION_FAILED	400
APPROVAL_IDEMPOTENCY_CONFLICT	409
APPROVAL_POLICY_INVALID	422
APPROVAL_TOKEN_CONSUMED	403
APPROVAL_TOKEN_EXPIRED	403
APPROVAL_TOKEN_INVALID	403
APPROVAL_TOKEN_REQUIRED	403
ARTIFACT_ATTACHMENT_INVALID	400
ARTIFACT_IDEMPOTENCY_CONFLICT	409
ARTIFACT_NAMESPACE_DENIED	403
ARTIFACT_NOT_FOUND	404
ARTIFACT_QUOTA_EXCEEDED	409
ARTIFACT_STORAGE_UNAVAILABLE	503
ARTIFACT_TOO_LARGE	413
ARTIFACT_UPLOAD_BUSY	503
ARTIFACT_VALIDATION_FAILED	400
AUTH_ADMIN_REQUIRED	403
AUTH_IDENTITY_REQUIRED	401
AUTH_KEY_EXPIRED	401
AUTH_KEY_INVALID	401
AUTH_KEY_MISSING	401
AUTH_KEY_REVOKED	401
AUTH_REQUEST_ALREADY_REVIEWED	409
AUTH_REQUEST_DISABLED	403
AUTH_REQUEST_NOT_FOUND	404
AUTH_REQUEST_VALIDATION_FAILED	400
AUTH_REQUIRED	401
AUTH_SCOPE_DENIED	403
BEST_OF_GROUP_CARDINALITY_EXCEEDED	409
BEST_OF_GROUP_NOT_FOUND	404
BEST_OF_GROUP_RING_ACCESS_DENIED	403
BEST_OF_GROUP_SPEC_NOT_VISIBLE	403
BEST_OF_GROUP_SPEC_REQUIRED	403
BRIEFING_INVALID_SINCE	400
BRIEFING_RING_FORBIDDEN	403
BRIEFING_VALIDATION_FAILED	400
BRIEFING_WINDOW_TOO_LARGE	400
BRIEFING_WINDOW_TOO_SMALL	400
CHECKOUT_ACTIVE_CONFLICT	409
CHECKOUT_ALREADY_EXISTS	409
CHECKOUT_INITIAL_STATE_INVALID	422
CHECKOUT_LIFECYCLE_REQUIRES_COMMAND	422
CHECKOUT_NOT_FOUND	404
CHECKOUT_TRANSITION_INVALID	409
CIRCLE_DUPLICATE	409
CIRCLE_FORBIDDEN	403
CIRCLE_ID_INVALID	400
CIRCLE_NOT_FOUND	404
CIRCLE_RING_NOT_FOUND	404
CIRCLE_VALIDATION_FAILED	400
COMMAND_NOT_FOUND	404
DB_CONNECT_FAILED	503
DB_QUERY_TIMEOUT	503
DB_SCHEMA_APPLY_FAILED	500
DELIVERY_ALREADY_EXISTS	409
DELIVERY_INITIAL_STATE_INVALID	422
DELIVERY_LIFECYCLE_REQUIRES_COMMAND	422
DELIVERY_NOT_FOUND	404
DELIVERY_PRIMARY_REQUIRES_PROMOTION	422
DELIVERY_PROMOTE_RACE_LOST	409
DELIVERY_TRANSITION_INVALID	409
DISC_PEER_DUPLICATE	409
DISC_PEER_NOT_FOUND	404
DISC_VALIDATION_FAILED	400
DISPATCHER_ALREADY_ACTIVE	409
DISPATCHER_IDENTITY_MISMATCH	403
DISPATCHER_NOT_FOUND	404
DISPATCHER_RECOVERY_LIMIT_EXCEEDED	409
DISPATCHER_RELEASE_LIMIT_EXCEEDED	409
DISPATCHER_VALIDATION_FAILED	400
EMBEDDING_DIMENSION_MISMATCH	422
EMBEDDING_PROVIDER_ERROR	500
EMBEDDING_PROVIDER_UNAVAILABLE	503
EXECUTION_DIAGNOSE_SCOPE_DENIED	403
EXECUTION_IDEMPOTENCY_CONFLICT	409
EXECUTION_LIFECYCLE_QUARANTINED	409
EXECUTION_PATCH_VALIDATION_FAILED	400
EXECUTION_RING_DENIED	403
EXECUTION_TASK_A2A_METADATA_RESERVED	422
EXECUTION_TASK_CLAIM_FAILED	409
EXECUTION_TASK_DUPLICATE	409
EXECUTION_TASK_NOT_FOUND	404
EXECUTION_TASK_NOT_READY	409
EXECUTION_TASK_VALIDATION_FAILED	400
EXECUTION_TRANSITION_ID_INVALID	400
EXECUTOR_KIND_NOT_AUTHORIZED	403
FED_CONFIG_INVALID	503
FED_DELIVERY_FAILED	500
FED_HOP_LIMIT	400
FED_KEY_GENERATION_CONFLICT	409
FED_KEY_NOT_FOUND	404
FED_KEY_REJECTED	403
FED_PEER_DENIED	403
FED_PEER_INACTIVE	409
FED_PEER_MISSING	400
FED_PROOF_FAILED	403
FED_PROOF_INVALID	400
FED_PROOF_MISSING	401
FED_RECEIPT_INVALID	502
FED_REPLAY_DETECTED	403
FED_REQUEST_INVALID	400
FED_RESOURCE_CONFLICT	409
FED_SCOPE_DENIED	403
FED_TRUST_ALREADY_ESTABLISHED	409
FED_TRUST_EXPIRED	403
FED_TRUST_INACTIVE	409
FED_TRUST_NOT_ESTABLISHED	403
FED_TRUST_NOT_FOUND	404
FED_VERSION_REQUIRED	400
FED_VERSION_UNSUPPORTED	400
FILL_ID_INVALID	400
GLOBAL_ACK_REMOVED	410
GRAPH_EDGE_NOT_FOUND	404
GRAPH_MEMORY_NOT_FOUND	404
GRAPH_SELF_REFERENCE	400
HEALTH_DB_UNREACHABLE	503
HEALTH_PROBE_BUSY	503
HTTP_BODY_NOT_ALLOWED	400
HTTP_BODY_REQUIRED	400
HTTP_BODY_TOO_LARGE	413
HTTP_CONTENT_ENCODING_UNSUPPORTED	415
HTTP_JSON_MALFORMED	400
HTTP_MEDIA_TYPE_UNSUPPORTED	415
IDENTITY_ID_INVALID	400
IDENTITY_NOT_FOUND	404
IDENTITY_VALIDATION_FAILED	400
IDENTITY_WALLET_DUPLICATE	409
INBOUND_CONFIG_INVALID	500
INBOX_CURSOR_INVALID	400
INBOX_CURSOR_STALE	409
INBOX_ITEM_NOT_FOUND	404
INBOX_RECEIPT_INVALID	422
INBOX_RECEIPT_VALIDATION_FAILED	400
INTERNAL_HTTP_ERROR	500
INTERNAL_SERVER_ERROR	500
INVALID_FILTER	400
INVALID_SPAWN_HINT	422
INVITE_ALREADY_REDEEMED	409
INVITE_ENROLLMENT_MISMATCH	409
INVITE_INSTANCE_UNINITIALIZED	409
INVITE_NOT_FOUND	404
INVITE_REVOKED	409
INVITE_TYPE_MISMATCH	409
INVITE_VALIDATION_FAILED	400
LEASE_ACQUISITION_QUIESCED	503
LEASE_GENERATION_MISMATCH	409
LEASE_GENERATION_REQUIRED	400
LEASE_LEGACY_QUARANTINED	409
LEASE_MUTATION_REQUIRES_COMMAND	422
LEASE_NOT_CURRENT	409
LEASE_PROTOCOL_REQUIRED	428
LEASE_ROLLOUT_INVALID_TRANSITION	409
LEASE_ROLLOUT_NOT_DRAINED	409
LEASE_ROLLOUT_WAIT_REQUIRED	409
LEGACY_TASK_EMIT_REMOVED	422
LIBRARY_ACCESS_DENIED	403
LIBRARY_ASK_FAILED	500
LIBRARY_CYCLE_DETECTED	400
LIBRARY_DEPTH_LIMIT_EXCEEDED	400
LIBRARY_DRILLDOWN_FAILED	500
LIBRARY_EVAL_FAILED	500
LIBRARY_EVAL_INVALID_REQUEST	400
LIBRARY_EVAL_NOT_FILE	400
LIBRARY_EVAL_PARSE_ERROR	400
LIBRARY_EVAL_STORAGE_UNAVAILABLE	503
LIBRARY_INVALID_PATH	400
LIBRARY_LIST_FAILED	500
LIBRARY_LLM_NOT_CONFIGURED	503
LIBRARY_PATH_NOT_FOUND	404
LIBRARY_RESOLVE_FAILED	500
MEMORY_CHARTER_ADMIN_REQUIRED	403
MEMORY_CHARTER_CONFLICT	409
MEMORY_CHARTER_NAMESPACE_REQUIRED	400
MEMORY_EXPORT_PAGE_TOO_SMALL	413
MEMORY_INVALID_TEMPORAL_RANGE	400
MEMORY_NAMESPACE_DENIED	403
MEMORY_NOT_FOUND	404
MEMORY_ORG_DENIED	403
MEMORY_QUERY_CONFLICTING_TEMPORAL_FLAGS	400
MEMORY_QUOTA_EXCEEDED	429
MEMORY_REMEMBER_PENDING	409
MEMORY_SHARE_NOT_FOUND	404
MEMORY_VALIDATION_FAILED	400
NOT_FOUND	404
OBJECT_STORAGE_OPERATION_ID_INVALID	400
OBJECT_STORAGE_QUOTA_BUSY	503
ORG_ALREADY_EXISTS	409
ORG_CENTRAL_CLAW_EXISTS	409
ORG_FILL_DUPLICATE	409
ORG_FILL_NOT_FOUND	404
ORG_MEMBERSHIP_DUPLICATE	409
ORG_MEMBERSHIP_NOT_FOUND	404
ORG_NOT_FOUND	404
ORG_RING_DUPLICATE	409
ORG_RING_NOT_FOUND	404
ORG_ROLE_DUPLICATE	409
ORG_ROLE_NOT_FOUND	404
ORG_VALIDATION_FAILED	400
OUTBOUND_ABORTED	503
OUTBOUND_CONCURRENCY_LIMIT	503
OUTBOUND_CONFIG_INVALID	500
OUTBOUND_DESTINATION_BLOCKED	400
OUTBOUND_DNS_FAILED	502
OUTBOUND_HEADER_INVALID	400
OUTBOUND_HEADER_TOO_LARGE	413
OUTBOUND_METHOD_INVALID	400
OUTBOUND_REDIRECT_BLOCKED	502
OUTBOUND_REQUEST_TOO_LARGE	413
OUTBOUND_RESPONSE_TOO_LARGE	502
OUTBOUND_TIMEOUT	503
OUTBOUND_TRANSPORT_FAILED	502
OUTBOUND_URL_INVALID	400
PLATFORM_ADAPTER_ALREADY_ACTIVE	409
PLATFORM_ADAPTER_IDENTITY_MISMATCH	403
PLATFORM_ADAPTER_NOT_FOUND	404
PLATFORM_ADAPTER_VALIDATION_FAILED	400
POLICY_CROSS_ORG_DENIED	403
POLICY_DENIED	403
POLICY_IDENTITY_MISMATCH	403
POLICY_MEMBERSHIP_REQUIRED	403
PRODUCTION_PROOF_EVIDENCE_FAILED	503
PRODUCTION_PROOF_EXCHANGE_FAILED	503
PRODUCTION_PROOF_REQUEST_CONFLICT	409
PRODUCTION_PROOF_REQUEST_INVALID	400
PRODUCTION_PROOF_UNAUTHORIZED	403
RATE_LIMIT_EXCEEDED	429
RATE_LIMIT_UNAVAILABLE	503
REGISTRY_AGENT_NOT_FOUND	404
REGISTRY_OWNER_MISMATCH	403
REGISTRY_RESOLUTION_FAILED	502
REGISTRY_UNAVAILABLE	503
REHYDRATE_UNSTABLE	409
RESTART_CONFIRMATION_REQUIRED	400
RESTART_FROM_REVERTED_REQUIRED	409
RFC291_ADMIN_NOT_IMPLEMENTED	501
RFC291_ROLLOUT_VALIDATION_FAILED	400
RING_ID_INVALID	400
RING_NOT_FOUND	404
ROLE_ID_INVALID	400
RPC_INTERNAL_ERROR	500
RPC_INVALID_PARAMS	400
RPC_INVALID_REQUEST	400
RPC_METHOD_NOT_FOUND	404
RPC_PARSE_ERROR	400
RPC_PREFLIGHT_REJECTED	400
RUN_ATTEMPT_NOT_FOUND	404
RUN_COMPLETION_DELIVERY_REQUIRED	409
RUN_TERMINAL_TRANSITION_REQUIRES_COMMAND	422
RUN_TRANSITION_INVALID	409
SERVER_DEPENDENCY_UNAVAILABLE	503
SERVER_DRAINING	503
SERVER_NOT_READY	503
SERVER_OVERLOADED	503
SERVER_REQUEST_ABORTED	499
SERVER_REQUEST_TIMEOUT	504
SIGNAL_ACK_NOT_FOUND	404
SIGNAL_ACK_UNAUTHORIZED	403
SIGNAL_ACK_VALIDATION_FAILED	400
SIGNAL_CANCEL_INVALID_STATUS	422
SIGNAL_CANCEL_NOT_FOUND	404
SIGNAL_CANCEL_NOT_TASK	422
SIGNAL_CANCEL_UNAUTHORIZED	403
SIGNAL_CANCEL_VALIDATION_FAILED	400
SIGNAL_CLAIM_CONFLICT	409
SIGNAL_CLAIM_INVALID_STATUS	422
SIGNAL_CLAIM_NOT_TASK	422
SIGNAL_CLAIM_VALIDATION_FAILED	400
SIGNAL_DEAD_LETTER	400
SIGNAL_DELIVERY_INVALID_TRANSITION	422
SIGNAL_EMIT_INVALID_TYPE	400
SIGNAL_EMIT_VALIDATION_FAILED	400
SIGNAL_EXTEND_EXPIRED	409
SIGNAL_EXTEND_NOT_CLAIMER	403
SIGNAL_ID_INVALID	400
SIGNAL_IDEMPOTENCY_CONFLICT	409
signal_inbox_acknowledge_batch_invalid	400
signal_inbox_acknowledge_invalid	400
signal_inbox_invalid_boolean	400
signal_inbox_invalid_order	400
signal_inbox_invalid_receipt_state	400
signal_inbox_invalid_since	400
signal_inbox_invalid_view	400
signal_inbox_resolve_invalid	400
signal_inbox_snooze_invalid	400
signal_inbox_snooze_past	422
signal_inbox_unsnooze_invalid	400
SIGNAL_LEASE_OUT_OF_BOUNDS	400
SIGNAL_NOT_FOUND	404
SIGNAL_RESOURCE_INVALID	400
SIGNAL_RING_MEMBERSHIP_REQUIRED	403
SIGNAL_ROLE_NOT_HELD	403
SIGNAL_SERVICE_UNAVAILABLE	503
SIGNAL_TAG_CONFLICT	400
SIGNAL_THREAD_SCOPE_INVALID	400
SIWE_CHAIN_NOT_ALLOWED	400
SIWE_CHALLENGE_EXPIRED	400
SIWE_CHALLENGE_MISMATCH	400
SIWE_CHALLENGE_NOT_FOUND	400
SIWE_CHALLENGE_USED	409
SIWE_CONFIG_INVALID	500
SIWE_DOMAIN_MISMATCH	400
SIWE_MESSAGE_INVALID	400
SIWE_VALIDATION_FAILED	400
SIWE_VERIFICATION_FAILED	401
SIWE_VERIFIER_UNAVAILABLE	503
STREAM_AUDIENCE_CHANGED	409
STREAM_CURSOR_EXPIRED	409
STREAM_CURSOR_FOREIGN	403
STREAM_CURSOR_UNKNOWN	409
STREAM_LIMIT_EXCEEDED	429
STREAM_SLOW_CONSUMER	409
STREAM_TICKET_NOT_IMPLEMENTED	501
STREAM_TICKET_VALIDATION_FAILED	400
SURREAL_SCHEMA_COERCION	400
TASK_DEPENDENCY_ACTIVE_EXECUTION_CONFLICT	409
TASK_DEPENDENCY_CYCLE	409
TASK_DEPENDENCY_DUPLICATE	409
TASK_DEPENDENCY_INVALID	422
TASK_DEPENDENCY_NOT_FOUND	404
TASK_DEPENDENCY_PROJECTION_READ_ONLY	422
TASK_DEPENDENCY_SCOPE_MISMATCH	403
TASK_DEPENDENCY_SELF_REFERENCE	422
TASK_GRAPH_LIMIT_EXCEEDED	422
TASK_NOT_CLAIMED_BY_CALLER	409
TASK_TRANSITION_CONFLICT	409
TASK_TRANSITION_INVALID	409
thread_fetch_failed	500
VALIDATION_FIELD_REQUIRED	400
VALIDATION_INVALID_TYPE	400
WEBHOOK_DELIVERY_ACTIVE	409
WEBHOOK_DELIVERY_MUTATION_REQUIRES_COMMAND	422
WEBHOOK_DELIVERY_NOT_REPLAYABLE	409
WEBHOOK_IDEMPOTENCY_CONFLICT	409
WEBHOOK_NOT_FOUND	404
WEBHOOK_OUTBOX_NOT_FOUND	404
WEBHOOK_OUTBOX_NOT_REPLAYABLE	409
WEBHOOK_STORAGE_OPERATION_UNSUPPORTED	501
WEBHOOK_SUBSCRIPTION_INVALID	422
WEBHOOK_SUBSCRIPTION_LIMIT_EXCEEDED	409
WEBHOOK_VALIDATION_FAILED	400
WORKFLOW_NAMESPACE_DENIED	403
WORKFLOW_NAMESPACE_MISMATCH	422
WORKFLOW_QUOTA_EXCEEDED	413
WORKFLOW_STORAGE_UNAVAILABLE	503
WORKFLOW_VALIDATION_FAILED	400
WORKSPACE_CONFLICT	409
WORKSPACE_ITEM_ID_INVALID	400
WORKSPACE_NAMESPACE_DENIED	403
WORKSPACE_NOT_FILE	422
WORKSPACE_NOT_FOUND	404
WORKSPACE_NOT_TEXT	422
WORKSPACE_QUOTA_EXCEEDED	409
WORKSPACE_REVISION_ID_INVALID	400
WORKSPACE_STORAGE_UNAVAILABLE	503
WORKSPACE_TOO_LARGE	413
WORKSPACE_VALIDATION_FAILED	400
WORKSTREAM_DUPLICATE	409
WORKSTREAM_ID_INVALID	400
WORKSTREAM_LINK_CAPACITY_EXCEEDED	409
WORKSTREAM_LINK_DUPLICATE	409
WORKSTREAM_LINK_NOT_FOUND	404
WORKSTREAM_NAMESPACE_DENIED	403
WORKSTREAM_NOT_FOUND	404
WORKSTREAM_RESOURCE_NAMESPACE_MISMATCH	409
WORKSTREAM_RESOURCE_NOT_FOUND	404
WORKSTREAM_VALIDATION_FAILED	400