Response Codes

Appwrite 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 (e.g., a required parameter was omitted, invalid input, etc.). Codes in the 5xx range indicate an error with the Appwrite server, but these are rare.

Error Messages

When the Appwrite APIs return error messages, it does so in JSON format. For example, an error might look like this:

{
    "message": "Invalid id: Parameter must be a valid number",
    "type": "argument_invalid",
    "code": 400
}

Error Types

Appwrite also passes convenient error types in addition to the HTTP response codes to help you get more fine grained control over what went wrong and allowing you to display relevant error messages in your applications. Error types are convenient to identify the type of error that occurred.

For eg: A 400 HTTP response code could indicate a Bad Request due to a variety of reasons and error types can help you pinpoint the exact 400 error. Appwrite currently supports the following error types: