Join us for our Developer Platform Hackathon, May 16-17. Apply now →
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.databases.update({
database_id: "d9824bdc-8445-4327-be8b-5b47500af6ce",
title: [{ text: { content: "Updated Database Title" } }]
}){
"object": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Update a database
Updates the attributes — the title, description, icon, or cover, etc. — of a specified database.
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.databases.update({
database_id: "d9824bdc-8445-4327-be8b-5b47500af6ce",
title: [{ text: { content: "Updated Database Title" } }]
}){
"object": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Returns the updated database object. To update theDocumentation Index
Fetch the complete documentation index at: https://developers.notion.com/llms.txt
Use this file to discover all available pages before exploring further.
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.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Path Parameters
ID of a Notion database, a container for one or more data sources.
Body
The parent page or workspace to move the database to. If not provided, the database will not be moved.
- Page Id
- Workspace
Show child attributes
Show child attributes
The updated title of the database, if any. If not provided, the title will not be updated.
100- Text
- Mention
- Equation
Show child attributes
Show child attributes
The updated description of the database, if any. If not provided, the description will not be updated.
100- Text
- Mention
- Equation
Show child attributes
Show child attributes
Whether 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.
- File Upload
- Emoji
- External
- Custom Emoji
- Icon
Show child attributes
Show child attributes
The updated cover image for the database, if any. If not provided, the cover will not be updated.
- File Upload
- External
Show child attributes
Show child attributes
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.