link_slug_taken (409)

← Error reference

link_slug_taken

HTTP status: 409

Retryable: No — retrying without changes will fail the same way.

The chosen link slug is already in use by another verification link in your account.

When it fires

A `POST /v1/links` request supplied a `link_slug` that already exists for the calling org and mode. Slugs must be unique per `(org, mode)` pair because they form the public-facing URL path applicants visit.

How to handle it

Choose a different slug and retry. The conflicting slug is returned in `details.link_slug`. If you did not specify a `link_slug`, the server derived one from your label; try a more specific label or supply an explicit slug.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/link_slug_taken",
    "code": "link_slug_taken",
    "message": "A link with this slug already exists in your account. Choose a different slug.",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/link_slug_taken",
    "details": {
      "reason": "slug_conflict",
      "link_slug": "my-link"
    }
  }
}