custom_domain_limit_exceeded

{
  "meta": {
    "requestId": "req_2c9a0jf23l4k567"
  },
  "error": {
    "detail": "Your plan does not allow another custom domain. Upgrade your plan, or remove a domain you no longer need, then retry.",
    "status": 403,
    "title": "Forbidden",
    "type": "https://unkey.com/docs/errors/unkey/limits/custom_domain_limit_exceeded"
  }
}

​

What Happened?

​

How To Fix

1. Check how many domains the workspace already holds, and whether any are still in use.
2. Remove one you no longer need, from the app’s settings page in the dashboard.
3. If they are all still in use, upgrade the plan to raise the allowance.
4. Retry the request.

# Attach the domain once the allowance has room
curl -X POST https://api.unkey.com/v2/domains.createDomain \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer unkey_YOUR_API_KEY" \
  -d '{
        "project": "payments",
        "app": "payments-api",
        "environment": "production",
        "domain": "api.acme.com"
      }'

​

Common Mistakes

• Expecting the allowance to be per environment: A domain in each environment still counts against one workspace-wide allowance.
• Counting only verified domains: A domain still pending verification occupies the allowance, so an abandoned setup keeps taking a slot.
• Retrying on a schedule: Nothing about the workspace changes between attempts, so a retry loop fails until the plan or the domain list changes.

​

Related Errors

• err:unkey:data:domain_already_exists - When the name is already attached to this workspace
• err:unkey:authorization:forbidden - When the root key or its workspace is disabled