This is an archive version of the document. To get the most up-to-date information, see the current version.

HTTP Response Codes

In this article

    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

    Success

    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.