Refer to the status codes documentation for an up-to-date list of error codes.
"code" and "message" properties.
| HTTP Status Code | "code" | Description |
|---|---|---|
| 400 | "invalid_json" | The request body could not be decoded as JSON. |
| 400 | "invalid_request_url" | The request URL is not valid. |
| 400 | "invalid_request" | This request is not supported. |
| 400 | "validation_error" | The request body does not match the schema for the expected parameters. Check the "message" property for more details. |
| 400 | "missing_version" | The request is missing the required Notion-Version header. See Versioning. |
| 401 | "unauthorized" | The bearer token is not valid. |
| 403 | "restricted_resource" | Given the bearer token used, the client doesn’t have permission to perform this operation. |
| 404 | "object_not_found" | Given the bearer token used, the resource does not exist. This error can also indicate that the resource has not been shared with owner of the bearer token. |
| 409 | "conflict_error" | The transaction could not be completed, potentially due to a data collision. Make sure the parameters are up to date and try again. |
| 429 | "rate_limited" | This request exceeds the number of requests allowed. Slow down and try again. More details on rate limits. |
| 500 | "internal_server_error" | An unexpected error occurred. Reach out to Notion support. |
| 503 | "service_unavailable" | Notion is unavailable. Try again later. This can occur when the time to respond to a request takes longer than 60 seconds, the maximum request timeout. |
| 503 | "database_connection_unavailable" | Notion’s database is unavailable or in an unqueryable state. Try again later. |
| 504 | "gateway_timeout" | Notion timed out while attempting to complete this request. Please try again later. |
| 529 | "service_overload" | Notion is temporarily overloaded. Respect the Retry-After response header and try again later. |