Errors

Otherwill 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 that failed given the information provided.

If there is an error while processing a request, the API will return an error status and message. The error message will contain more information about the error, such as if the model is not found or if there was an issue with the input data.


Status codes

Here is a list of the different categories of status codes returned by the Protocol API. Use these to understand if a request was successful.

  • Name
    200 OK
    Type
    Description

    Everything worked as expected.

  • Name
    201 Created
    Type
    Description

    The content resource has been successfully created.

  • Name
    400 Bad Request
    Type
    Description

    The request is missing required fields or has invalid data.

  • Name
    401 Unauthorized
    Type
    Description

    The access token provided is invalid or expired.

  • Name
    404 Not Found
    Type
    Description

    The content resource with the specified ID was not found.