Errors

ArcSite uses HTTP response codes to indicate the success or failure of a request. Codes within the 2xx range are considered as successfully completed requests. Codes within the 4xx and 5xx ranges will indicate that a failure has occurred.

The ArcSite API uses the following error codes:

Error Code	Meaning
400	Bad Request — Your request is invalid.
401	Unauthorized — Your API token is wrong.
404	Not Found — The specified resource could not be found.
405	Method Not Allowed — You tried to access an API with an invalid method.
406	Not Acceptable — You requested a format that isn’t json.
429	Too Many Requests — You have exceeded the rate limit.
500, 502, 503, 504	There is an issue with ArcSite. These are rare and we will be messaged when they occur.

Error response body

Most error responses include a JSON body with a human-readable message that explains what went wrong:

Error response

{
  "message": "Project name Backyard Fence already exists, please use another name."
}

Rate limits

Each company can make up to 5,000 API requests per hour. The limit counts requests to all endpoints and is shared by all API tokens of the company. The count resets at the start of each hour (UTC).

Requests over the limit return 429 Too Many Requests:

Rate limit response

{
  "message": "Too many requests. Please wait before trying again."
}

When you receive a 429, wait until the next hour starts before you retry.