All error codes

ssh_key_name_taken

HTTP 409 An SSH key with this name already exists

What happened

You already have a key with this name and different key material. The same name with the same material is not an error - it returns the existing key with 200.

What to do

Send the new key under a different name, or delete the existing key with DELETE /v1/ssh-keys/{id} and repeat the same request with the same idempotency key. Keys cannot be renamed or edited, and the platform will not overwrite the existing key silently.

Retrying

Change the state this refers to, then repeat the same request with the same idempotency key.

How it arrives

{
    "type": "https://docs.fiberax.com/errors/ssh_key_name_taken",
    "title": "An SSH key with this name already exists",
    "status": 409,
    "code": "ssh_key_name_taken",
    "request_id": "a277dcd1ca652c65"
}

Branch your code on code, never on the wording of title.