HTTP Response Codes

FreeClimb uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error in the HTTP request provided, and codes in the 5xx range indicate an internal FreeClimb error.

Response Headers

When a POST request is made FreeClimb generates a unique request ID that is returned in the response header. FreeClimb will reuse this request ID if there are multiple webhooks for your initial request. This request ID can be used with the Performance Query Language (PQL) to Filter Logs.

Code

Description

200 - OK

Request was successfully processed.

201 - Created

Resource was successfully created.

202 - Accepted

Request was successfully queued and is being processed

204 - No Content

Request was successfully processed; the response does not include a message body.

400 - Bad Request

Request was unacceptable, often due to an invalid parameter value or missing a required parameter.

401 - Unauthorized

Account credentials were invalid.

403 - Forbidden

Account credentials not authorized.

404 - Not Found

Requested resource doesn’t exist. In most cases it means the call/queue/conference/etc doesn't exist.

Note that when working with calls within queues and conferences, it may mean the particular call doesn't exist within the conference or the queue.

Using the REST API to manipulate a completed call can also result in a 404, even though the live call did exist in the past. While a completed call can be used with a GET, it can't be used with a POST.

405 - Method Not Allowed

HTTP Method in the request was invalid.

409 - Conflict

Request could not be completed due to a conflict with the current state of the resource.

500, 502, 503, 504 - Server Errors

Error on FreeClimb's end.