Skip to main content

Field-level error codes

The field-level code of one errors entry, or of an ingest or CSV row error. The vocabulary is open: new codes are additive.

required​

Absent, null, or empty where a value is needed.

unknown_field​

The operation does not define this field or parameter.

immutable​

The field exists, but this operation cannot change it.

invalid_type​

The value has the wrong JSON type.

invalid_format​

The value has the right type and the wrong syntax.

invalid_value​

The value is not one of the allowed values, or a cursor is not valid for this request.

too_long​

A string over its maximum length.

too_many​

An array over its maximum length.

out_of_range​

A number or date outside its bounds.

too_precise​

A number with more decimal places than the field stores.

duplicate​

A value repeated where values must be unique, or a member name repeated within one JSON object.

too_large​

An object over its maximum serialised size in bytes.

mutually_exclusive​

Set together with a field or parameter it excludes.

unknown_reference​

An id or key that names nothing in the workspace.

client_key_required​

The attribution guard refused the row: it is a model or outcome event, names no client, and its agent is assigned to two or more clients, so the server cannot tell which client it belongs to. Send the row again with its client_key.

currency_mismatch​

A currency differs from the workspace's currency: an ingested event's or CSV row's currency, or the currency sent with PUT /v1/price-table.