Shared
Models
APIErrorObject object{ type: "api_error", message }
type: "api_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
AuthenticationError object{ type: "authentication_error", message }
type: "authentication_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
BillingError object{ type: "billing_error", message }
type: "billing_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
ClaudeCodeKeyCreatorNotMemberErrorDetails object{ error_code }
ClaudeCodeVersionTooOldErrorDetails object{ error_code }
CMEKContextUnavailableErrorDetails object{ error_code }
CMEKKeyDisabledErrorDetails object{ error_code }
CMEKKeyNetworkBlockedErrorDetails object{ error_code }
CMEKKeyUnreachableErrorDetails object{ error_code }
EnforcedSpendLimitReachedErrorDetails object{ error_code }
ErrorDetails = AvailableToolsLimitExceededErrorDetails or ClaudeCodeKeyCreatorNotMemberErrorDetails or ClaudeCodeVersionTooOldErrorDetails or 83 more
ErrorObject = InvalidRequestError or AuthenticationError or BillingError or 6 more
ErrorResponse object{ type: "error", error, request_id }
ErrorType = "invalid_request_error" or "authentication_error" or "billing_error" or 9 more
GatewayTimeoutError object{ type: "timeout_error", message }
type: "timeout_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
InvalidRequestError object{ type: "invalid_request_error", message }
type: "invalid_request_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
NotFoundError object{ type: "not_found_error", message }
type: "not_found_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
OrganizationOnHoldErrorDetails object{ error_code, appeal_url }
OrganizationTypeNotSupportedErrorDetails object{ error_code }
OverloadedError object{ type: "overloaded_error", message }
type: "overloaded_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
ParentOrganizationRequiredErrorDetails object{ error_code }
PermissionError object{ type: "permission_error", message }
type: "permission_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
RampLimitExceededErrorDetails object{ error_code }
RateLimitError object{ type: "rate_limit_error", message }
type: "rate_limit_error"The broad category of the error.
The broad category of the error.
message: stringA human-readable explanation of the error. Its wording can change, so don't match on it.
A human-readable explanation of the error. Its wording can change, so don't match on it.
RequestBodyEncodingInvalidErrorDetails object{ error_code }
RequestBodyEncodingUnsupportedErrorDetails object{ error_code }
RequestBodyTooLargeAfterDecodingErrorDetails object{ error_code }
SandboxEgressRestrictedErrorDetails object{ error_code }
Errors
"claude_code_key_creator_not_member"HTTP status 400The 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.
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: ClaudeCodeKeyCreatorNotMemberErrorDetails { error_code }
"claude_code_version_too_old"HTTP status 400The request comes from a Claude Code version older than the minimum that the requested model or the organization requires. Update Claude Code, then retry.
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: ClaudeCodeVersionTooOldErrorDetails { error_code }
"cmek_key_disabled"HTTP status 400The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.
The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.
details: CMEKKeyDisabledErrorDetails { error_code }
"cmek_key_network_blocked"HTTP status 400The key management service's network access controls blocked the request to the workspace's customer-managed encryption key. The key itself may be healthy.
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: CMEKKeyNetworkBlockedErrorDetails { error_code }
"organization_on_hold"HTTP status 400Anthropic 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.
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: OrganizationOnHoldErrorDetails { error_code, appeal_url }
"organization_type_not_supported"HTTP status 400The endpoint does not support the organization's type. Each endpoint's description says which organization types it supports.
The endpoint does not support the organization's type. Each endpoint's description says which organization types it supports.
details: OrganizationTypeNotSupportedErrorDetails { error_code }
"parent_organization_required"HTTP status 400The endpoint serves only organizations that belong to a parent organization, and this organization belongs to none.
The endpoint serves only organizations that belong to a parent organization, and this organization belongs to none.
details: ParentOrganizationRequiredErrorDetails { error_code }
"request_body_encoding_invalid"HTTP status 400The request body is not valid for its Content-Encoding.
The request body is not valid for its Content-Encoding.
details: RequestBodyEncodingInvalidErrorDetails { error_code }
"request_body_encoding_unsupported"HTTP status 400The request's Content-Encoding is not supported.
The request's Content-Encoding is not supported.
details: RequestBodyEncodingUnsupportedErrorDetails { error_code }
"sandbox_egress_restricted"HTTP status 403The 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.
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: SandboxEgressRestrictedErrorDetails { error_code }
"request_body_too_large_after_decoding"HTTP status 413The compressed request body exceeds the request size limit once decoded.
The compressed request body exceeds the request size limit once decoded.
details: RequestBodyTooLargeAfterDecodingErrorDetails { error_code }
"enforced_spend_limit_reached"HTTP status 429The organization has crossed the monthly API usage threshold of its API tier.
The organization has crossed the monthly API usage threshold of its API tier.
details: EnforcedSpendLimitReachedErrorDetails { error_code }
"ramp_limit_exceeded"HTTP status 429The request would exceed a ramp limit, which caps how fast usage can grow. Retry after the time in the retry-after header.
The request would exceed a ramp limit, which caps how fast usage can grow. Retry after the time in the retry-after header.
details: RampLimitExceededErrorDetails { error_code }
"cmek_context_unavailable"HTTP status 503The workspace's encryption settings could not be read, so the request was refused. Retry in a few minutes.
The workspace's encryption settings could not be read, so the request was refused. Retry in a few minutes.
details: CMEKContextUnavailableErrorDetails { error_code }
"cmek_key_unreachable"HTTP status 503The 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.
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.