HTTP Response Codes
At a glance
FreeClimb utilizes standard RESTful HTTP status codes to communicate request outcomes, returning 2xx for successful operations, 4xx for client-side errors (such as invalid parameters or unauthorized credentials), and 5xx for internal server issues. Additionally, every POST response generates a unique request ID header that can be used to track and filter logs across multiple associated webhooks.
FreeClimb uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the
2xxrange indicate success, codes in the4xxrange indicate an error in the HTTP request provided, and codes in the5xx rangeindicate 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. |
Updated 9 days ago