Notion API - Public Beta (English)
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments

Status codes

Responses from the API use HTTP response codes are used to indicate general classes of success and error.

Success codes#

HTTP status codeDescription
200Notion successfully processed the request.

Error codes#

Error responses contain more detail about the error in the response body, in the "code" and "message" properties.
HTTP status code"code""message"
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.
Modified at 2023-04-28 06:00:22
Previous
Request limits
Next
Authentication
Built with