Backend API errors

{
  "shortMessage": "cannot revoke",
  "longMessage": "Actor token cannot be revoked because its status is <status>. Only pending tokens can be revoked.",
  "code": "actor_token_cannot_be_revoked_code"
}

{
  "shortMessage": "cannot revoke agent task",
  "longMessage": "cannot revoke agent task",
  "code": "agent_task_cannot_be_revoked"
}

{
  "shortMessage": "agent task not found",
  "longMessage": "The requested agent task could not be found.",
  "code": "agent_task_not_found"
}

{
  "shortMessage": "user not found",
  "longMessage": "The user of the agent task no longer exists. Please request a new one.",
  "code": "agent_task_subject_not_found"
}

{
  "shortMessage": "Identifier not found",
  "longMessage": "No identifier was found with id <identifierID>",
  "code": "resource_not_found"
}

{
  "shortMessage": "duplicate allowlist identifier",
  "longMessage": "the identifier <identifier> already exists",
  "code": "duplicate_record"
}

{
  "shortMessage": "API Keys not enabled",
  "longMessage": "API Keys not enabled",
  "code": "api_keys_not_enabled"
}

{
  "shortMessage": "Application not found",
  "longMessage": "No application was found with the given claim token.",
  "code": "resource_not_found"
}

{
  "shortMessage": "Missing authorization scopes",
  "longMessage": "Missing authorization scopes",
  "code": "authorization_missing_scopes",
  "meta": {
    "scopes": "missing"
  }
}

{
  "shortMessage": "Could not authenticate request.",
  "longMessage": "Could not authenticate request.",
  "code": "could_not_authenticate_request"
}

{
  "shortMessage": "already exists",
  "longMessage": "This <identifier> already exists.",
  "code": ""
}

{
  "shortMessage": "Country code not allowed.",
  "longMessage": "Phone number sign ups are not allowed for this country code. Please use a different method.",
  "code": "not_allowed_access",
  "meta": {
    "name": "phone_number"
  }
}

{
  "shortMessage": "Access not allowed.",
  "longMessage": "<who> <pluralization> not allowed to access this application.",
  "code": "not_allowed_access",
  "meta": "{\"Identifiers\": identifiers}"
}

{
  "shortMessage": "Invalid authentication",
  "longMessage": "Unable to authenticate the request, you need to supply an active session",
  "code": "authentication_invalid"
}

{
  "shortMessage": "Unauthorized request",
  "longMessage": "You are not authorized to perform this request",
  "code": "authorization_invalid"
}

{
  "shortMessage": "Invalid Authorization header format",
  "longMessage": "Invalid Authorization header format. Must be 'Bearer <YOUR_API_KEY>'",
  "code": "authorization_header_format_invalid"
}

{
  "shortMessage": "The provided Clerk Secret Key is invalid. Make sure that your Clerk Secret Key is correct.",
  "longMessage": "The provided Clerk Secret Key is invalid. Make sure that your Clerk Secret Key is correct.",
  "code": "clerk_key_invalid"
}

{
  "shortMessage": "Invalid request for environment",
  "longMessage": "Request only valid for <envTypes> instances.",
  "code": "request_invalid_for_environment"
}

{
  "shortMessage": "Rate limited country code",
  "longMessage": "SMS to the country <countryName> is temporarily disabled. Please try again later.",
  "code": "unsupported_country_code",
  "meta": "{\"Alpha2\": alpha2, \"CountryCode\": countryCode}"
}

{
  "shortMessage": "Invalid request for instance",
  "longMessage": "This request is not valid for your instance. Modify your instance settings to use this request.",
  "code": "request_invalid_for_instance"
}

{
  "shortMessage": "This email address is already in use.",
  "longMessage": "This email address is already in use. Creating multiple accounts with the same email address is not allowed.",
  "code": "not_allowed_access"
}

{
  "shortMessage": "Unsupported country code",
  "longMessage": "Phone numbers from this country (<countryName>) are currently not supported. For more information, please contact <support>.",
  "code": "unsupported_country_code",
  "meta": "{\"Alpha2\": alpha2, \"CountryCode\": countryCode}"
}

{
  "shortMessage": "Identifier not found",
  "longMessage": "No identifier was found with id <identifierID>",
  "code": "resource_not_found"
}

{
  "shortMessage": "duplicate blocklist identifier",
  "longMessage": "the identifier <identifier> already exists",
  "code": "duplicate_record"
}

{
  "shortMessage": "Client not found",
  "longMessage": "No client was found with id <clientID>",
  "code": "resource_not_found"
}

{
  "shortMessage": "No client found",
  "longMessage": "This request is expecting a client and did not find one",
  "code": "client_not_found"
}

{
  "shortMessage": "Annual only plans are not enabled",
  "longMessage": "Annual only plans are not enabled, please enable the update in Clerk dashboard.",
  "code": "billing_annual_only_plans_not_enabled"
}

{
  "shortMessage": "access denied",
  "longMessage": "The billing feature for organizations is not enabled for this instance. You can enable it at https://dashboard.clerk.com.",
  "code": "billing_not_enabled"
}

{
  "shortMessage": "access denied",
  "longMessage": "The billing feature for users is not enabled for this instance. You can enable it at https://dashboard.clerk.com.",
  "code": "billing_not_enabled"
}

{
  "shortMessage": "Another checkout is already in progress",
  "longMessage": "Another checkout is already in progress",
  "code": "checkout_already_in_progress"
}

{
  "shortMessage": "Insufficient seats",
  "longMessage": "You have reached the seat limit for your current plan.",
  "code": "insufficient_seats",
  "meta": {
    "seatsquantity": "totalneeded"
  }
}

{
  "shortMessage": "Subscription item already canceled",
  "longMessage": "You can't cancel a subscription item that is already canceled",
  "code": "commerce_subscription_item_already_canceled"
}

{
  "shortMessage": "Subscription item cannot be canceled",
  "longMessage": "Subscription item cannot be canceled because <reason>",
  "code": "commerce_subscription_item_cannot_be_canceled"
}

{
  "shortMessage": "Subscription item cannot be ended",
  "longMessage": "Subscription item cannot be ended because <reason>",
  "code": "commerce_subscription_item_cannot_be_ended"
}

{
  "shortMessage": "Invalid currency",
  "longMessage": "Currency is not supported",
  "code": "currency_invalid"
}

{
  "shortMessage": "Default plan price creation forbidden",
  "longMessage": "Custom prices cannot be created for default plans. Only custom paid plans support additional pricing",
  "code": "default_plan_price_creation_forbidden"
}

{
  "shortMessage": "Insufficient credit balance",
  "longMessage": "The decrease amount exceeds the current credit balance",
  "code": "insufficient_credit_balance",
  "meta": {
    "name": "amount"
  }
}

{
  "shortMessage": "Invalid credit action",
  "longMessage": "Credit action must be either 'increase' or 'decrease'",
  "code": "invalid_credit_action"
}

{
  "shortMessage": "Invalid credit amount",
  "longMessage": "Credit amount must be greater than zero",
  "code": "invalid_credit_amount"
}

{
  "shortMessage": "Missing plan ID",
  "longMessage": "Plan ID is required to perform this operation",
  "code": "missing_plan_id"
}

{
  "shortMessage": "Organization member limit exceeded",
  "longMessage": "Plan change is not allowed because the organization's <occupiedSeatsStr> occupied seats exceed the limit of <maxAllowedStr> organization memberships.",
  "code": "org_member_limit_exceeded_for_plan_change"
}

{
  "shortMessage": "Out of date price",
  "longMessage": "There was a mismatch in the price transition. The price may have been changed by another request.",
  "code": "out_of_date_price"
}

{
  "shortMessage": "Payee not active",
  "longMessage": "Payee is not active",
  "code": "payee_not_active"
}

{
  "shortMessage": "Payee not found",
  "longMessage": "Payee not found",
  "code": "payee_not_found"
}

{
  "shortMessage": "Payee status is invalid",
  "longMessage": "Payee status is invalid",
  "code": "payee_status_invalid"
}

{
  "shortMessage": "Payer not found",
  "longMessage": "Payer not found",
  "code": "payer_not_found"
}

{
  "shortMessage": "Requires confirmation",
  "longMessage": "The payment attempt failed because it requires additional confirmation, which is not currently supported. Please use a different payment method.",
  "code": "payment_attempt_failed_requires_confirmation"
}

{
  "shortMessage": "Your card was declined",
  "longMessage": "The card was declined.",
  "code": "payment_attempt_failed_card_declined"
}

{
  "shortMessage": "Card expired",
  "longMessage": "The card has expired.",
  "code": "payment_attempt_failed_card_expired"
}

{
  "shortMessage": "Insufficient funds",
  "longMessage": "The card has insufficient funds.",
  "code": "payment_attempt_failed_card_insufficient_funds"
}

{
  "shortMessage": "Payment method required",
  "longMessage": "A payment method is required to upgrade from a free plan. The subscription payer must add a payment method before this transition can be completed.",
  "code": "payment_method_required_for_transition"
}

{
  "shortMessage": "Processing error",
  "longMessage": "There was a processing error with the payment method.",
  "code": "payment_attempt_failed_processing_error"
}

{
  "shortMessage": "Paid plan month or annual fee invalid",
  "longMessage": "Paid plan month or annual fee invalid",
  "code": "plan_amount_invalid"
}

{
  "shortMessage": "Paid plan monthly base fee exceeds upper limit",
  "longMessage": "Paid plan monthly base fee must be less than $999,999.99",
  "code": "plan_amount_exceeds_upper_limit"
}

{
  "shortMessage": "Plan does not support empty organizations",
  "longMessage": "This plan cannot be applied to an organization without members.",
  "code": "plan_does_not_support_empty_orgs"
}

{
  "shortMessage": "Free trials disabled",
  "longMessage": "Free trials are disabled for this plan",
  "code": "plan_free_trials_disabled"
}

{
  "shortMessage": "Plan not found",
  "longMessage": "Plan not found",
  "code": "plan_not_found"
}

{
  "shortMessage": "Plan seat limit exceeded",
  "longMessage": "Your organization has <currentMembersStr> members, but the requested plan would only support <seatLimitStr> members. Please remove members before switching to this plan.",
  "code": "plan_seat_limit_exceeded",
  "meta": "{\"PlanSeatLimit\": planSeatLimit, \"CurrentMembers\": currentMembers}"
}

{
  "shortMessage": "Price transition not allowed",
  "longMessage": "Price transition not allowed because <reason>",
  "code": "price_transition_not_allowed"
}

{
  "shortMessage": "Seat-based billing exceeds plan's organization member limit",
  "longMessage": "The seat-based plan you are trying to create exceeds your Clerk plan's organization member limit. Adjust your seat limits to match your plan's limit or upgrade your subscription.",
  "code": "seat_based_billing_exceeds_org_member_limit"
}

{
  "shortMessage": "Subscription already ended",
  "longMessage": "Subscription is already ended",
  "code": "subscription_already_ended"
}

{
  "shortMessage": "Subscription item is no longer active",
  "longMessage": "The subscription item is no longer the payer's active subscription item. It may have been changed by another request.",
  "code": "subscription_item_no_longer_active"
}

{
  "shortMessage": "Subscription item not found",
  "longMessage": "Subscription item not found",
  "code": "subscription_item_not_found"
}

{
  "shortMessage": "Subscription item is not in free trial",
  "longMessage": "Subscription item is not in free trial",
  "code": "subscription_item_not_in_free_trial"
}

{
  "shortMessage": "Subscription not found",
  "longMessage": "Subscription not found",
  "code": "subscription_not_found"
}

{
  "shortMessage": "Supported billing period mismatch",
  "longMessage": "<field> cannot be set when supported_billing_periods is %q",
  "code": "supported_billing_period_mismatch",
  "meta": {
    "name": "field"
  }
}

{
  "shortMessage": "Invalid unit price amount per block",
  "longMessage": "Unit price '<unitName>' tier %d has invalid amount_per_block '%d'. Amount per block must be non-negative (>= 0)",
  "code": "unit_price_amount_per_block_invalid"
}

{
  "shortMessage": "Invalid unit price block size",
  "longMessage": "Unit price block size '%d' is not supported. Supported block size: %d",
  "code": "unit_price_block_size_invalid"
}

{
  "shortMessage": "Invalid unit price currency",
  "longMessage": "Unit price currency '<currency>' is not supported. Only '<validCurrency>' is currently supported for unit prices",
  "code": "unit_price_currency_invalid"
}

{
  "shortMessage": "Invalid tier range",
  "longMessage": "Unit price '<unitName>' tier %d has ends_after_block (%d) less than starts_at_block (%d). The end must be greater than or equal to the start",
  "code": "unit_price_ends_after_block_invalid"
}

{
  "shortMessage": "Free tier cannot follow a paid tier",
  "longMessage": "Unit price '<unitName>' tier %d is free but a preceding tier is paid. Once a tier is paid, all subsequent tiers must also be paid",
  "code": "unit_price_free_tier_after_paid_tier"
}

{
  "shortMessage": "Invalid unit price name",
  "longMessage": "Unit price name '<name>' is not supported. Supported names: <validName>",
  "code": "unit_price_name_invalid"
}

{
  "shortMessage": "Unit prices not allowed for user plans",
  "longMessage": "unit_prices can only be provided for organization plans, not user plans",
  "code": "unit_prices_not_allowed_for_user_plans"
}

{
  "shortMessage": "Invalid unit price starts at block",
  "longMessage": "Unit price starts at block '%d' is not supported. Supported starts at block: %d",
  "code": "unit_price_starts_at_block_invalid"
}

{
  "shortMessage": "Gap or overlap in tier ranges",
  "longMessage": "Unit price '<unitName>' tier %d should start at block %d but starts at %d. Tiers must be continuous with no gaps or overlaps",
  "code": "unit_price_tier_gap_or_overlap_detected"
}

{
  "shortMessage": "Tiers missing",
  "longMessage": "Unit price '<unitName>' must have at least one tier defined",
  "code": "unit_price_tiers_missing"
}

{
  "shortMessage": "Unlimited tier must be last",
  "longMessage": "Unit price '<unitName>' tier %d has unlimited range (null ends_after_block) but is not the last tier. Only the last tier can be unlimited",
  "code": "unit_price_unlimited_tier_must_be_last"
}

{
  "shortMessage": "",
  "code": "cookie_invalid"
}

{
  "shortMessage": "",
  "longMessage": "The client's rotating key does not match the given one <token>",
  "code": "cookie_invalid"
}

{
  "shortMessage": "",
  "longMessage": "The token is missing the following claims: <claims>",
  "code": "cookie_invalid"
}

{
  "shortMessage": "endpoint is deprecated and pending removal",
  "longMessage": "endpoint is deprecated and pending removal",
  "code": "operation_deprecated"
}

{
  "shortMessage": "Discount already applied",
  "longMessage": "This subscription item already has an active discount applied",
  "code": "discount_already_applied"
}

{
  "shortMessage": "Discount inactive",
  "longMessage": "This discount is not currently active",
  "code": "discount_inactive"
}

{
  "shortMessage": "Discount not applicable",
  "longMessage": "This discount cannot be applied to this subscription item",
  "code": "discount_not_applicable_to_subscription_item"
}

{
  "shortMessage": "Discount not found",
  "longMessage": "The discount was not found",
  "code": "discount_not_found"
}

{
  "shortMessage": "Domain update was forbidden",
  "longMessage": "Domain can be only updated for production instances",
  "code": "domain_update_forbidden"
}

{
  "shortMessage": "custom domain required",
  "longMessage": "<feature> requires a custom domain. Add a custom domain to unlock this feature.",
  "code": "feature_requires_custom_domain"
}

{
  "shortMessage": "",
  "longMessage": "Clerk Frontend API cannot be accessed through the proxy URL. Make sure your proxy is configured correctly.",
  "code": "invalid_proxy_configuration",
  "meta": {
    "name": "proxy_url"
  }
}

{
  "shortMessage": "operation not allowed",
  "longMessage": "This operation is not allowed on a primary domain. Try again with a satellite domain of the instance.",
  "code": "operation_not_allowed_on_primary_domain"
}

{
  "shortMessage": "primary domain already exists",
  "longMessage": "Currently, only a single primary domain is supported and the current instance already has one. All new domains need to be set a satellites.",
  "code": "primary_domain_already_exists",
  "meta": {
    "name": "is_satellite"
  }
}

{
  "shortMessage": "operation not allowed",
  "longMessage": "*<provider> domains are not supported for production instances. Please purchase a domain then try again.",
  "code": "provider_domain_operation_not_allowed"
}

{
  "shortMessage": "proxy URL required",
  "longMessage": "Provider domain <domainName> requires a proxy URL. Provider domains must be configured with a proxy.",
  "code": "proxy_url_required_for_provider_domain",
  "meta": {
    "name": "paramname"
  }
}

{
  "shortMessage": "Development monthly email limit exceeded",
  "longMessage": "The monthly limit for email messages in development (%d) has been reached. Please use test emails (https://go.clerk.com/test-emails) instead",
  "code": "dev_monthly_email_limit_exceeded",
  "meta": "{\"DevMonthlyEmailLimit\": limit}"
}

{
  "shortMessage": "Email template customization is locked",
  "longMessage": "Email template customization is locked. Revert to the default template or contact support to regain customization access.",
  "code": "email_template_customization_locked"
}

{
  "shortMessage": "Email template customization rate limit exceeded",
  "longMessage": "The email template customization rate limit was exceeded. Please try again later or contact support if you continue to experience issues.",
  "code": "email_template_customization_rate_limited"
}

{
  "shortMessage": "Email template update blocked",
  "longMessage": "Email template update blocked",
  "code": "email_template_suspicious_blocked"
}

{
  "shortMessage": "No Enterprise Connection for this sign-up",
  "longMessage": "The current sign-up does not have a corresponding Enterprise Connection. Please check the domain of the provided email address.",
  "code": "enterprise_sso_sign_up_connection_missing"
}

{
  "shortMessage": "not enabled",
  "longMessage": "This feature is not enabled on this instance",
  "code": "feature_not_enabled"
}