Claude Platform Docs

Shared

Models
api_error_object: object{ type: "api_error", message }
type: "api_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

authentication_error: object{ type: "authentication_error", message }
type: "authentication_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

billing_error: object{ type: "billing_error", message }
type: "billing_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

claude_code_key_creator_not_member_error_details: object{ error_code }
error_code: "claude_code_key_creator_not_member"
claude_code_version_too_old_error_details: object{ error_code }
error_code: "claude_code_version_too_old"
cmek_context_unavailable_error_details: object{ error_code }
error_code: "cmek_context_unavailable"
cmek_key_disabled_error_details: object{ error_code }
error_code: "cmek_key_disabled"
cmek_key_network_blocked_error_details: object{ error_code }
error_code: "cmek_key_network_blocked"
cmek_key_unreachable_error_details: object{ error_code }
error_code: "cmek_key_unreachable"
enforced_spend_limit_reached_error_details: object{ error_code }
error_code: "enforced_spend_limit_reached"
error_response: object{ type: "error", error, request_id }
type: "error"
One of the following:
request_id: string
error_type: "invalid_request_error" or "authentication_error" or "billing_error" or 9 more
"invalid_request_error"
"authentication_error"
"billing_error"
"permission_error"
"not_found_error"
"rate_limit_error"
"timeout_error"
"api_error"
"overloaded_error"
"memory_precondition_failed_error"
"memory_path_conflict_error"
"conflict_error"
gateway_timeout_error: object{ type: "timeout_error", message }
type: "timeout_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

invalid_request_error: object{ type: "invalid_request_error", message }
type: "invalid_request_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

not_found_error: object{ type: "not_found_error", message }
type: "not_found_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

organization_on_hold_error_details: object{ error_code, appeal_url }
error_code: "organization_on_hold"
appeal_url: optional string
organization_type_not_supported_error_details: object{ error_code }
error_code: "organization_type_not_supported"
overloaded_error: object{ type: "overloaded_error", message }
type: "overloaded_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

parent_organization_required_error_details: object{ error_code }
error_code: "parent_organization_required"
permission_error: object{ type: "permission_error", message }
type: "permission_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

ramp_limit_exceeded_error_details: object{ error_code }
error_code: "ramp_limit_exceeded"
rate_limit_error: object{ type: "rate_limit_error", message }
type: "rate_limit_error"

The broad category of the error.

message: string

A human-readable explanation of the error. Its wording can change, so don't match on it.

request_body_encoding_invalid_error_details: object{ error_code }
error_code: "request_body_encoding_invalid"
request_body_encoding_unsupported_error_details: object{ error_code }
error_code: "request_body_encoding_unsupported"
request_body_too_large_after_decoding_error_details: object{ error_code }
error_code: "request_body_too_large_after_decoding"
sandbox_egress_restricted_error_details: object{ error_code }
error_code: "sandbox_egress_restricted"
Errors
"claude_code_key_creator_not_member"⁠HTTP status 400

The API key belongs to the Claude Code workspace, and the user who created it is no longer a member of the organization or of that workspace.

details: object{ error_code }
error_code: "claude_code_key_creator_not_member"
"claude_code_version_too_old"⁠HTTP status 400

The request comes from a Claude Code version older than the minimum that the requested model or the organization requires. Update Claude Code, then retry.

details: object{ error_code }
error_code: "claude_code_version_too_old"
"cmek_key_disabled"⁠HTTP status 400

The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.

details: object{ error_code }
error_code: "cmek_key_disabled"
"cmek_key_network_blocked"⁠HTTP status 400

The key management service's network access controls blocked the request to the workspace's customer-managed encryption key. The key itself may be healthy.

details: object{ error_code }
error_code: "cmek_key_network_blocked"
"organization_on_hold"⁠HTTP status 400

Anthropic has disabled the organization for trust and safety reasons. An organization disabled for any other reason, such as billing, does not get this code. appeal_url, when present, is where the organization can appeal.

details: object{ error_code, appeal_url }
error_code: "organization_on_hold"
appeal_url: optional string
"organization_type_not_supported"⁠HTTP status 400

The endpoint does not support the organization's type. Each endpoint's description says which organization types it supports.

details: object{ error_code }
error_code: "organization_type_not_supported"
"parent_organization_required"⁠HTTP status 400

The endpoint serves only organizations that belong to a parent organization, and this organization belongs to none.

details: object{ error_code }
error_code: "parent_organization_required"
"request_body_encoding_invalid"⁠HTTP status 400

The request body is not valid for its Content-Encoding.

details: object{ error_code }
error_code: "request_body_encoding_invalid"
"request_body_encoding_unsupported"⁠HTTP status 400

The request's Content-Encoding is not supported.

details: object{ error_code }
error_code: "request_body_encoding_unsupported"
"sandbox_egress_restricted"⁠HTTP status 403

The request came from a Claude sandbox with restricted network access, which is not allowed to make this change. Send it from outside the sandbox, or from a sandbox with unrestricted network access.

details: object{ error_code }
error_code: "sandbox_egress_restricted"
"request_body_too_large_after_decoding"⁠HTTP status 413

The compressed request body exceeds the request size limit once decoded.

details: object{ error_code }
error_code: "request_body_too_large_after_decoding"
"enforced_spend_limit_reached"⁠HTTP status 429

The organization has crossed the monthly API usage threshold of its API tier.

details: object{ error_code }
error_code: "enforced_spend_limit_reached"
"ramp_limit_exceeded"⁠HTTP status 429

The request would exceed a ramp limit, which caps how fast usage can grow. Retry after the time in the retry-after header.

details: object{ error_code }
error_code: "ramp_limit_exceeded"
"cmek_context_unavailable"⁠HTTP status 503

The workspace's encryption settings could not be read, so the request was refused. Retry in a few minutes.

details: object{ error_code }
error_code: "cmek_context_unavailable"
"cmek_key_unreachable"⁠HTTP status 503

The workspace's customer-managed encryption key could not be reached. Retry the request; if this continues, check that the key is available in your key management service, or contact Anthropic support.

details: object{ error_code }
error_code: "cmek_key_unreachable"