HTTP Codes
Migration Notes from 0.5 API
- HTTP error codes are modified from the 0.5 API.
HTTP Codes
Buzz uses HTTP status codes to indicate whether a request was successful. If the response's HTTP code is 200, all worked well. The following codes represent various outcomes:
| HTTP Code | Meaning |
|---|---|
| 200 | Indicates success for GET, PUT, and PATCH requests. Also success of a functional POST request that does not create a new object. |
| 201 | Indicates that a new object was created successfully. Usually expected for POST requests. |
| 204 | Indicates that the request was processed successfully but no content was available. For example, a GET request to /reporting/async-query returns 204 when the requested report id is recognized but not yet ready. This is also the status of a successful DELETE request. |
| 400 | Validation, parsing or other processing errors. |
| 401 | Not authenticated. |
| 403 | Indicates that the resource is forbidden. This includes when a resource is not enabled for the Buzz Key, when a user is trying to write but only has read permissions, etc. |
| 404 | Resource not found |
| 405 | Method not allowed by API. For example, some elements are read-only and cannot accept POST requests. |
| 406 | The user specified an “accept” header that is not supported on that resource. |
Updated over 3 years ago