Skip to content
Settings

COMPOSITE_KEY_UNSUPPORTED — backend does not support composite unique keys

cyoda-go version 0.8.2

COMPOSITE_KEY_UNSUPPORTED — the active storage backend does not support composite unique key enforcement.

HTTP: 422 Unprocessable Entity. Retryable: no.

Composite unique key enforcement is an optional capability that storage backends may or may not implement. This error is returned when a model defines one or more unique keys but the backend does not implement the CompositeUniqueKeyCapable interface.

To resolve: use a backend that supports composite unique keys, or remove the unique key definitions from the model.

  • errors
  • errors.UNIQUE_VIOLATION
  • errors.INVALID_UNIQUE_KEY_DEFINITION
  • cyoda help errors — Every error response from the Cyoda REST API carries a structured errorCode in the properties object. Multiple codes may share the same HTTP status. Programmatic handling keys on errorCode, not HTTP status.
  • cyoda help errors UNIQUE_VIOLATION — The entity payload contains field values that collide with an existing entity’s composite unique key. Unlike an optimistic-concurrency CONFLICT (which is retryable), a unique-key violation is a permanent data constraint — retrying the same payload without changing the key field values will produce the same result.
  • cyoda help errors INVALID_UNIQUE_KEY_DEFINITION — Each unique key on a model must have a non-empty list of field paths, a unique name within the model, and field paths that resolve to existing, non-ambiguous fields in the model schema. This error is returned when a submitted model definition violates one of these structural requirements.