Response
Upon successful request, the response includes data and 200 OK (GET)
, 201 CREATED (POST)
, 200 OK (PATCH)
, or 204 NO CONTENT (DELETE)
as the HTTP code. If the request fails, the response is one of the following error codes:
Response | What triggers the response? |
---|---|
400 (Bad Request) | If the request is not sent in valid JSON. Specify a Content-Type: application/json header in your request. If you sent valid JSON, the error may also mean specific fields that were invalid. |
401 | If your API token was missing or included in the body rather than the header. |
403 | If you provided an API token but it was invalid or revoked, or if you don't have read/write access to the entity you're trying to view/edit. |
404 | If the id used in the request was inaccurate or you don't have permission to view/edit it. |
429 | If you hit a rate limit for the API. If you receive this response, we recommend waiting at least 60 seconds before re-attempting the request. |
503 | If the API is overloaded or down for maintenance. If you receive this response, we recommend waiting at least 60 seconds before re-attempting the request. |