HTTP Response Codes
The request to the server can return a successful status or an error.
Success Operation Statuses
Code | Applies to HTTP Method | Description | Response Body Content | Details |
---|---|---|---|---|
200 | GET PUT | OK | Resource representation | The operation has been successfully completed. |
201 | POST | Created | Representation of the created resource | The resource has been successfully created. |
202 | POST DELETE | Accepted | n/a | The request has been accepted and a task to handle the request has been created. A 202 response is typically used for actions that take a long while to process or performed asynchronously. This response is accompanied by a task resource. |
204 | PUT POST DELETE | No Content | n/a | The request is valid and has been successfully completed; the response does not include a body. A 204 status can be sent, for example, as a response to the DELETE HTTP request, informing that a resource has been deleted and has no representation. |
Error operation statuses
Code | Applies to HTTP Method | Description | Response Body Content | Details |
---|---|---|---|---|
400 | POST PUT | Bad Request | Error | The request body is malformed, incomplete or otherwise invalid. |
401 | All | Unauthorized | Error | The authorization header has been expected but not found (or found but is expired). |
403 | All | Forbidden | Error | The user sending a request does not have adequate privileges to access one or more objects specified in the request. |
404 | All | Not Found | Error | One or more resources specified in the request could not be found in the specified resource collection. |
405 | All | Method is not Allowed | Error | The HTTP method specified in the request is not supported for this resource. |
500 | GET POST PUT | Internal Server Error | Error | The request has been received but could not be completed because of an internal error at the server side. |
501 | POST PUT DELETE | Not Implemented | Error | The server does not support the functionality required to fulfill the request. |
503 | All | Service Unavailable | Error | The server is currently unable to handle the request due to a temporary overloading or maintenance of the server. |