Each 400 Bad Request response will be accompanied by an error code containing more information. The following tables lists all possible error codes, what they mean, and what you can do to address each one:
Key-related errors
Error code
Description
EMPTY_KEY
Key cannot be empty.
INVALID_KEY
The provided key does not match the regex: /^(?!\s+$)[a-zA-Z0-9:._\s-#]+$/
KEY_TOO_LONG
The provided key has exceeded the maximum 500 characters.
NOT_FOUND
The specified key does not exist.
Value-related errors
Error code
Description
MAX_SIZE
The provided value has exceeded the maximum size limit.
MAX_DEPTH
The provided value has exceeded the maximum object depth (32) limit.
Entity-related errors
Error code
Description
ENTITY_TYPE_TOO_SHORT
The provided key needs to be more than 3 characters.
ENTITY_TYPE_TOO_LARGE
The provided key has exceeded the maximum 60 characters.
INVALID_ENTITY_TYPE
The provided key does not match the regex: /^(?![\.\-])(?!.*\.{2})[a-z0-9:\-.]*(?<![.])$/.
INVALID_ENTITY_VALUE
Entity values must match one of the types defined in Custom Entities.
INVALID_ENTITY_ATTRIBUTE
The specified attribute name is a reserved value and cannot be utilized.
INVALID_ENTITY_INDEX
The custom entity index provided is invalid. The index name is a reserved value and cannot be utilized.
Query-related errors
Error code
Description
COMPLEX_QUERY_PAGE_LIMIT_NOT_IN_RANGE
The page limit must be set between 1 and 100.
EMPTY_FILTER_OPERATOR
Filter operators "and" and "or" cannot be empty.
INVALID_FILTER_OPERATORS_COMBINATION
Filter operators "and" and "or" cannot be present at the same level.
INSUFFICIENT_FILTER_VALUES
The specified condition needs at least two values.