Error Codes

The Appwrite API attempts to return appropriate HTTP status codes for every request.

Code Text Description
200 OK Success!
304 Not Modified There was no new data to return.
400 Bad Request The request was invalid or cannot be otherwise served. An accompanying error message will explain further. Requests with wrong or invalid input will yield this response.
401 Unauthorized Missing or incorrect authentication credentials, Also happens when API key or user permission or not sufficient.
403 Forbidden The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why.
404 Not Found The URI requested is invalid or the resource requested, such as a user, does not exists.
429 Too Many Requests Returned in when a request cannot be served due to the application’s rate limit having been exhausted for the resource. See Rate Limits
500 Internal Server Error Something is broken. You are recommended to check our status page or contact our support team.
503 Service Unavailable The Appwrite servers are up, but overloaded with requests. Try again later.
504 Gateway timeout The Appwrite servers are up, but the request couldn’t be serviced due to some failure within our stack. Try again later.

Error Messages

When the Appwrite APIs returns 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",
    "code": 400