15 known error codes for this model

bad_gateway Moderate

Gateway layer returned an invalid upstream response to the API client.

conflict_error Moderate

The requested mutation conflicts with current object state/version.

database_connection_unavailable Moderate

Notion backend could not complete request due to transient dependency failure.

gateway_timeout Moderate

Gateway timed out waiting for upstream Notion service response.

internal_server_error Call a Pro

Notion encountered an unexpected internal processing error.

invalid_json Easy Fix

Request JSON body is malformed and cannot be parsed.

invalid_request Easy Fix

Request shape is invalid for this endpoint method.

invalid_request_url Easy Fix

Endpoint URL or route path is invalid for the Notion API.

missing_version Easy Fix

Required Notion-Version header is missing from request.

object_not_found Easy Fix

Requested page/database/block ID was not found or shared with integration.

rate_limited Moderate

Notion rate limits were exceeded for this integration.

restricted_resource Easy Fix

Integration token does not have access to the requested resource.

service_unavailable Call a Pro

Notion service is temporarily unavailable for this request path.

unauthorized Easy Fix

Notion rejected the request due to missing or invalid bearer token.

validation_error Easy Fix

Field-level payload validation failed for the target operation.