Error handling

The Webflow Data API uses standard HTTP status 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 a client-side error (e.g., a problem with the request), and codes in the 5xx range indicate a server-side error.

Error response body

When an error occurs, the API will return a JSON object with the following properties:

Example error response body:

1
{
2
  "message": "Requested resource not found: The site cannot be found",
3
  "code": "resource_not_found",
4
  "externalReference": null,
5
  "details": []
6
}

Handling rate limit errors

If your application exceeds the rate limit, you will receive a 429 Too Many Requests error. When this happens, you should check the Retry-After header to see how long you should wait before making another request.

The official Webflow SDKs have built-in exponential backoff, which will automatically handle these retries for you. If you are not using one of our SDKs, you should implement your own retry logic.

For more information, see the rate limits documentation.

Common error codes