API errors

conflict

The request is valid but conflicts with the current state of the resource. The `detail` field says which conflict you hit.

409application/problem+json

What it means

The request could not be applied to the resource as it stands, for example because an identifier that must be unique (such as an externalProfileId) is already taken.

Conflicts a client can act on in a specific way have their own code, such as invalid_state_transition, concurrent_modification and limit_reached.

409 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "A profile with this externalProfileId already exists",
  "code": "conflict"
}

How to handle it

Read detail first; the right response depends on which conflict this is.
For a uniqueness conflict, look up the existing resource instead of retrying the create.

Errors reference