Skip to main content
PATCH
/
v1
/
databases
/
{database_id}
Update a database
curl --request PATCH \
  --url https://api.notion.com/v1/databases/{database_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "parent": {
    "type": "page_id",
    "page_id": "<string>"
  },
  "title": [
    {
      "text": {
        "content": "<string>",
        "link": {
          "url": "<string>"
        }
      },
      "annotations": {
        "bold": true,
        "italic": true,
        "strikethrough": true,
        "underline": true,
        "code": true,
        "color": "default"
      },
      "type": "<string>"
    }
  ],
  "description": [
    {
      "text": {
        "content": "<string>",
        "link": {
          "url": "<string>"
        }
      },
      "annotations": {
        "bold": true,
        "italic": true,
        "strikethrough": true,
        "underline": true,
        "code": true,
        "color": "default"
      },
      "type": "<string>"
    }
  ],
  "is_inline": true,
  "icon": {
    "file_upload": {
      "id": "<string>"
    },
    "type": "<string>"
  },
  "cover": {
    "file_upload": {
      "id": "<string>"
    },
    "type": "<string>"
  },
  "in_trash": true,
  "is_locked": true
}
'
{
  "object": "<unknown>",
  "message": "<string>",
  "code": "invalid_json",
  "status": "<unknown>",
  "additional_data": {}
}
Returns the updated database object. To update the 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Path Parameters

database_id
string
required

ID of a Notion database, a container for one or more data sources.

Body

application/json
parent
object

The parent page or workspace to move the database to. If not provided, the database will not be moved.

title
object[]

The updated title of the database, if any. If not provided, the title will not be updated.

Maximum array length: 100
description
object[]

The updated description of the database, if any. If not provided, the description will not be updated.

Maximum array length: 100
is_inline
boolean

Whether the database should be displayed inline in the parent page. If not provided, the inline status will not be updated.

icon
object

The updated icon for the database, if any. If not provided, the icon will not be updated.

cover
object

The updated cover image for the database, if any. If not provided, the cover will not be updated.

in_trash
boolean

Whether the database should be moved to or from the trash. If not provided, the trash status will not be updated.

is_locked
boolean

Whether the database should be locked from editing in the Notion app UI. If not provided, the locked state will not be updated.

Response

object
any
required
message
string
required
code
enum<string>
required
Available options:
invalid_json,
invalid_request_url,
invalid_request,
missing_version,
validation_error
status
any
required
additional_data
object