Responses from the API use HTTP response codes are used to indicate general classes of success and error. Error responses contain more detail about the error in the response body, in the
HTTP Status Code
The request body could not be decoded as JSON.
The request URL is not valid.
This request is not supported.
The request body does not match the schema for the expected parameters. Check the
The request is missing the required
The bearer token is not valid.
Given the bearer token used, the client doesn't have permission to perform this operation.
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.
The transaction could not be completed, potentially due to a data collision. Make sure the parameters are up to date and try again.
This request exceeds the number of requests allowed. Slow down and try again. More details on rate limits
An unexpected error occurred. Reach out to Notion support.
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.
Notion's database is unavailable or in an unqueryable state. Try again later.