Error Codes

Error codes and messages reference for CakeAuth platform.

Every error response contains a status code and a message. The status code indicates the type of error that occurred, while the message provides a brief description of the error. Please note that we always guarantee that the status code will be consistent. But, on the other hand, the message may change depending on the context.

Below is a reference of the error codes sorted by status code and code title. Each entry provides a brief description of the error, along with its associated HTTP status and error code and possible way to fix it.

`400 Bad Request`

`bad_request`

Default message: Bad request. Payload is invalid
Details: General error indicating the request payload is malformed or invalid

`invalid_payload`

Default message: Bad request. Payload is invalid
Details: Request payload format or content does not meet the expected requirements

`invalid_provider`

Default message: Provider value is invalid
Details: The authentication or service provider specified in the request is not supported or invalid

`invalid_authentication_strategy`

Default message: Authentication strategy is invalid
Details: The specified authentication method or strategy is not supported or configured incorrectly

`invalid_captcha_token`

Default message: Captcha token is missing, invalid, or expired
Details: The provided CAPTCHA verification token is not valid or has expired

`invalid_client_users_attempt`

Default message: Authentication attempt is invalid or expired
Details: The client user's authentication attempt has failed due to invalid credentials or expiration

`invalid_tenant_members_attempt`

Default message: Authentication attempt is invalid or expired
Details: The tenant member's authentication attempt has failed due to invalid credentials or expiration

`invalid_identifier_settings`

Default message: Identifier is invalid or not enabled for this project
Details: The user identifier configuration is not properly set up or enabled for the current project

`invalid_origin`

Default message: Request origin is unknown, invalid, or not allowed
Details: The request's origin domain is not in the list of allowed origins

`invalid_authorized_domains_settings`

Default message: No authorized domains were found. If you're an administrator, please set it up in the CakeAuth dashboard
Details: The project lacks configuration for authorized domains, requiring administrator setup

`invalid_project_id`

Default message: Project ID provided is invalid
Details: The specified project identifier does not exist or is malformed

`invalid_identifier_id`

Default message: User's identifier ID provided is invalid
Details: The provided user identifier is not valid or does not exist in the system

`invalid_organization_id`

Default message: Organization ID provided is invalid
Details: The specified organization identifier does not exist or is malformed

`invalid_environment_id`

Default message: Environment ID provided is invalid
Details: The specified environment identifier does not exist or is malformed

`invalid_session_id`

Default message: Session ID provided is invalid
Details: The provided session identifier is not valid or has expired

`external_id_already_exists`

Default message: Provided ID is already exists
Details: The external identifier being used is already associated with another resource

`identifier_already_exists`

Default message: Provided identifier is already exists
Details: The identifier being registered is already in use by another user

`tenant_member_already_exists`

Default message: This account is already registered
Details: The tenant member account being created already exists in the system

`domain_already_exists`

Default message: Domain is already registered
Details: The domain being added is already registered in the system

`invalid_environment_host`

Default message: Environment host is invalid
Details: The specified environment host is not properly configured or invalid

`key_pairs_unavailable`

Default message: Environment doesn't have any available key-pairs to sign the request
Details: No valid key pairs are configured for the environment to sign API requests

`401 Unauthorized`

`unauthorized`

Default message: Unauthorized request
Details: General error indicating the request lacks valid authentication credentials

`missing_credentials`

Default message: Credentials required are missing
Details: Required authentication credentials were not provided with the request

`invalid_client_credentials`

Default message: Provided user's credentials are invalid.
Details: The client user's authentication credentials are incorrect or expired

`invalid_tenant_credentials`

Default message: Provided credentials are invalid.
Details: The tenant's authentication credentials are incorrect or expired

`invalid_key`

Default message: API key is invalid
Details: The provided API key is not valid or has been revoked

`invalid_public_key`

Default message: Public key is missing or invalid
Details: The public key required for authentication is missing or invalid

`invalid_private_key`

Default message: Private key is missing or invalid
Details: The private key required for authentication is missing or invalid

`invalid_session`

Default message: Session is invalid, expired, or revoked
Details: The user's session is no longer valid and requires re-authentication

`403 Forbidden`

`forbidden`

Default message: Forbidden request
Details: The authenticated user does not have permission to access the requested resource

`domains_not_authorized`

Default message: The request comes from unauthorized domain
Details: The request origin domain is not in the list of authorized domains

`public_key_only`

Default message: This resource must only use the 'public key'. If you're accessing it with a 'private key' please rotate your private key immediately!
Details: The resource can only be accessed using a public key authentication

`private_key_only`

Default message: This resource must only use the 'private key'.
Details: The resource can only be accessed using a private key authentication

`insufficient_api_key`

Default message: This API key doesn't have access to this resources
Details: The provided API key lacks the necessary permissions for the requested resource

`inactive_tenant_member`

Default message: Your account is inactive
Details: The tenant member account is currently disabled or suspended

`inactive_project`

Default message: This project is inactive
Details: The requested project is currently disabled or suspended

`no_organization_access`

Default message: Don't have access to this organization
Details: The authenticated user lacks permissions to access the specified organization

`no_project_access`

Default message: Don't have access to this project
Details: The authenticated user lacks permissions to access the specified project

`no_environment_access`

Default message: Don't have access to this environment
Details: The authenticated user lacks permissions to access the specified environment

`max_org_reached`

Default message: Organization limit reached! During beta, max 2 organizations per member.
Details: Beta limitation reached for maximum number of organizations per member

`max_project_reached`

Default message: Project limit reached! During beta, max 3 projects per organization
Details: Beta limitation reached for maximum number of projects per organization

`404 Not Found`

`not_found`

Default message: Data not found
Details: The requested resource could not be found in the system

`identifiers_not_found`

Default message: User/identifiers was not found
Details: The specified user or identifier does not exist in the system

`identifiers_credentials_not_found`

Default message: Credential data for this user/identifier was not found. Please reset your password!
Details: User credentials are missing and require password reset

`identifiers_contact_information_not_found`

Default message: Contact information data for this user/identifier was not found
Details: Contact information for the specified user is missing

`tenant_member_credentials_not_found`

Default message: Credential data for your account was not found. Please sign out and reset your password!
Details: Tenant member credentials are missing and require password reset

`organization_not_found`

Default message: Organization was not found
Details: The specified organization does not exist in the system

`project_not_found`

Default message: Project was not found
Details: The specified project does not exist in the system

`environment_not_found`

Default message: Environment was not found
Details: The specified environment does not exist in the system

`tenant_member_not_found`

Default message: Account was not found
Details: The specified tenant member account does not exist

`key_not_found`

Default message: API key was not found
Details: The specified API key does not exist in the system

`environment_configurations_not_found`

Default message: Environment configuration was not found
Details: The configuration for the specified environment is missing

`domain_not_found`

Default message: Domain was not found
Details: The specified domain is not registered in the system

`429 Too Many Requests`

`too_many_requests`

Default message: Too many requests
Details: Rate limit exceeded for API requests

`attempt_limit_reached`

Default message: Maximum attempt limit's reached. Please try again in 1 hour!
Details: Too many failed attempts, temporary lockout enforced

`500 Internal Server Error`

`internal_server_error`

Default message: Internal server error. Please contact CakeAuth support!
Details: Unexpected server error requiring support intervention

`root_fetch`

Default message: Internal server error. Please contact CakeAuth support!
Details: Critical server error during root data fetch operation

Last updated on

Previous

Error Handling

Next

Rate limits

On this page

400 Bad Requestbad_requestinvalid_payloadinvalid_providerinvalid_authentication_strategyinvalid_captcha_tokeninvalid_client_users_attemptinvalid_tenant_members_attemptinvalid_identifier_settingsinvalid_origininvalid_authorized_domains_settingsinvalid_project_idinvalid_identifier_idinvalid_organization_idinvalid_environment_idinvalid_session_idexternal_id_already_existsidentifier_already_existstenant_member_already_existsdomain_already_existsinvalid_environment_hostkey_pairs_unavailable401 Unauthorizedunauthorizedmissing_credentialsinvalid_client_credentialsinvalid_tenant_credentialsinvalid_keyinvalid_public_keyinvalid_private_keyinvalid_session403 Forbiddenforbiddendomains_not_authorizedpublic_key_onlyprivate_key_onlyinsufficient_api_keyinactive_tenant_memberinactive_projectno_organization_accessno_project_accessno_environment_accessmax_org_reachedmax_project_reached404 Not Foundnot_foundidentifiers_not_foundidentifiers_credentials_not_foundidentifiers_contact_information_not_foundtenant_member_credentials_not_foundorganization_not_foundproject_not_foundenvironment_not_foundtenant_member_not_foundkey_not_foundenvironment_configurations_not_founddomain_not_found429 Too Many Requeststoo_many_requestsattempt_limit_reached500 Internal Server Errorinternal_server_errorroot_fetch