Errors
This page lists the possible errors you might encounter and what they mean.
Error object
{name: "REQUESTED_ENTITY_NOT_FOUND"code: 10004message: "List not found"}namestringThe name of the error.codenumberThe error code.messagestringA human-readable message describing the error.
Error codes
General error codes
10000UNKNOWNAn unknown error occurred.500 Interval Server Error10001MAINTENANCE_MODEjsonpad.io is currently in maintenance mode.502 Bad Gateway10002MALFORMED_REQUESTSomething in the request was malformed. Usually this is due to a missing token value.400 Bad Request10003VALIDATION_ERRORThe request failed validation. Details about the validation error will be included in the message. This could be due to a missing or invalid field in the request body, or the request body didn't match a JSON Schema when creating or updating an item.400 Bad Request10004REQUESTED_ENTITY_NOT_FOUNDThe requested entity (list, item, or index) was not found.404 Not Found10007RATE_LIMIT_EXCEEDEDThe rate limit for the API has been exceeded. Too many requests were sent in a short period of time, or requests were sent too quickly. See Rate Limits for more information.429 Too Many Requests10008MAX_LISTS_EXCEEDEDYour subscription plan has a limit on the number of lists you can create, and you have reached that limit.403 Forbidden10009MAX_ITEMS_EXCEEDEDYour subscription plan has a limit on the number of items you can create in a list, and you have reached that limit for the list in which you are trying to create an item.403 Forbidden10010MAX_INDEXES_EXCEEDEDYour subscription plan has a limit on the number of indexes you can create in a list, and you have reached that limit for the list in which you are trying to create an index.403 Forbidden10012MAX_IDENTITIES_EXCEEDEDYour subscription plan has a limit on the number of identities you can create, and you have reached that limit.403 Forbidden13001TOKEN_NOT_AUTHORIZEDThe token you provided is not authorized to perform the requested action. See Token Permissions for more information.403 Forbidden13002TOKEN_LOCKEDThe token you provided has been temporarily locked. This occurs when your subscription plan expires or you downgrade to a plan with a lower limit. In this case, any tokens that exceed the new limit will be locked but not deleted. You can unlock the token by upgrading your subscription plan or deleting some tokens.403 Forbidden17001SEARCH_QUERY_INVALIDThe search query provided in the request was too short. The search query must be at least 3 characters long.400 Bad Request
List error codes
14001LIST_READONLYThe list is read-only and cannot be modified. This includes items and indexes as well - you can't create, update, or delete items or indexes in a read-only list.403 Forbidden14002LIST_PROTECTEDYou tried to delete a protected list that still has some items in it. You will need to delete all items in the list before you can delete the list.403 Forbidden14003LIST_RESERVED_PATH_NAMEThe path name you provided is reserved. Some path names might be reserved for internal use, or they might cause ambiguity in URLs. Try a different path name.403 Forbidden14004LIST_LOCKEDThe list has been temporarily locked. This occurs when your subscription plan expires or you downgrade to a plan with a lower limit. In this case, any lists that exceed the new limit will be locked but not deleted. You can unlock the list by upgrading your subscription plan or deleting some lists.403 Forbidden14005LIST_UNABLE_TO_CREATEAn error occurred while creating the list. This could be due to a duplicate path name (the path name must be unique across all of your lists).400 Bad Request14006LIST_UNABLE_TO_UPDATEAn error occurred while updating the list.400 Bad Request14007LIST_UNABLE_TO_DELETEAn error occurred while deleting the list.400 Bad Request14008LIST_NOT_INDEXABLEThe list is not indexable. You cannot view a list of items in a non-indexable list. Also, non-indexable lists cannot be searched.403 Forbidden
Item error codes
15001ITEM_READONLYThe item is read-only and cannot be modified.403 Forbidden15002ITEM_LOCKEDThe item has been temporarily locked. This occurs when your subscription plan expires or you downgrade to a plan with a lower limit. In this case, any items that exceed the new limit will be locked but not deleted. You can unlock the item by upgrading your subscription plan or deleting some items.15003ITEM_UNABLE_TO_CREATEAn error occurred while creating the item.400 Bad Request15004ITEM_UNABLE_TO_RESTOREAn error occurred while restoring the item.400 Bad Request15005ITEM_UNABLE_TO_UPDATEAn error occurred while updating the item.400 Bad Request15006ITEM_UNABLE_TO_DELETEAn error occurred while deleting the item.400 Bad Request15007ITEM_TOO_LARGEThe item's data is too large. The maximum size for an item's data will depend on your subscription plan.413 Request Too Long15008ITEM_VERSION_NOT_FOUNDThe requested version of the item was not found.404 Not Found15009ITEM_JSON_POINTER_NOT_FOUNDThe requested JSON pointer was not found in the item. This occurs when trying to create, update, or delete partial data at a specific path in the item's data.404 Not Found15010ITEM_UNABLE_TO_GENERATEAn error occurred while generating the item.400 Bad Request
Index error codes
16001INDEX_RESERVED_PATH_NAMEThe path name you provided is reserved. Some path names might be reserved for internal use, or they might cause ambiguity in URLs. Try a different path name.403 Forbidden16002INDEX_LOCKEDThe index has been temporarily locked. This occurs when your subscription plan expires or you downgrade to a plan with a lower limit. In this case, any indexes that exceed the new limit will be locked but not deleted. You can unlock the index by upgrading your subscription plan or deleting some indexes.403 Forbidden16003INDEX_UNABLE_TO_CREATEAn error occurred while creating the index.400 Bad Request16004INDEX_UNABLE_TO_UPDATEAn error occurred while updating the index.400 Bad Request16005INDEX_UNABLE_TO_DELETEAn error occurred while deleting the index.400 Bad Request
Identity error codes
20001IDENTITY_RESERVED_NAMEThe identity name you provided is reserved. Some names might be reserved for internal use, or they might cause ambiguity in URLs. Try a different name.403 Forbidden20002IDENTITY_LOCKEDThe identity has been temporarily locked. This occurs when your subscription plan expires or you downgrade to a plan with a lower limit. In this case, any identities that exceed the new limit will be locked but not deleted. You can unlock the identity by upgrading your subscription plan or deleting some identities.403 Forbidden20003IDENTITY_UNABLE_TO_CREATEAn error occurred while creating the identity.400 Bad Request20004IDENTITY_UNABLE_TO_UPDATEAn error occurred while updating the identity.400 Bad Request20005IDENTITY_UNABLE_TO_DELETEAn error occurred while deleting the identity.400 Bad Request20006IDENTITY_ALREADY_REGISTEREDYou tried to register a new identity while authenticated as an existing identity. Logout or omit identity authentication headers and try again.403 Forbidden20007IDENTITY_ALREADY_AUTHENTICATEDYou to tried to login using an identity while authenticated as an existing identity. Logout or omit identity authentication headers and try again.403 Forbidden20008IDENTITY_NOT_AUTHENTICATEDAn incorrect identity token was provided, or no identity token was provided when accessing and endpoint that requires identity authentication.401 Unauthorized20009IDENTITY_TOO_MANY_ATTEMPTS429 Too Many RequestsIdentity authentication failed too many times in a short period of time. This helps to protect against brute force attacks.
The amount of time you need to wait before trying again will increase on every failed attempt. Try again in a few minutes.