conflict: The account or link already exists

The economic-account routes answer conflict when the request would duplicate something that already exists: an account for an address that is already anchored, a handle that is taken, or (for clients pinned at Dynamo-Version: 1.7.0 or later) an identity link whose proof is already linked to the account. Nothing changed.

What to do

A client pinned before 1.7.0 keeps its earlier answer to an identical re-link. On a single-tenant core a request that names no Dynamo-Version counts as pinned before 1.7.0; on the multi-tenant hosted tier it is served the account's default version (1.8.0 for new accounts).

On the wire

HTTP 409, error type conflict. Every client gets errorDetail, with or without Dynamo-Error-Detail: 1.

For a duplicate address or handle, message names it (for example "handle … is taken"), param is address or handle, and fix is "use a different address or handle". A client pinned before 1.8.0 gets the earlier doc_url form: the docs base followed by /errors/conflict.md (with the default docs base, a doubled errors/errors/ path). A re-linked proof:

{
  "error": "conflict",
  "errorDetail": {
    "type": "conflict",
    "code": "conflict",
    "message": "this proof is already linked to the account",
    "param": "type",
    "doc_url": "…/errors/conflict.md",
    "fix": "this proof is already linked to the account; nothing changed"
  }
}

See all error codes.