Updates the attributes — the title, description, icon, or cover, etc. — of a specified database.
properties of the data sources under a database, use the Update a data source API starting from API version 2025-09-03.
For an overview of how to use the REST API with databases, refer to the Working with databases guide.
Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The API version to use for this request. The latest version is 2025-09-03.
2025-09-03 ID of a Notion database, a container for one or more data sources.
The parent page or workspace to move the database to. If not provided, the database will not be moved.
The updated title of the database, if any. If not provided, the title will not be updated.
100The updated description of the database, if any. If not provided, the description will not be updated.
100Whether the database should be displayed inline in the parent page. If not provided, the inline status will not be updated.
The updated icon for the database, if any. If not provided, the icon will not be updated.
The updated cover image for the database, if any. If not provided, the cover will not be updated.
Whether the database should be moved to or from the trash. If not provided, the trash status will not be updated.
Whether the database should be locked from editing in the Notion app UI. If not provided, the locked state will not be updated.