Databases

Update a database

Changed on
patch/v1/databases/{database_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/databases/{database_id}
  • Auth
    HTTP bearer

Path parameters

database_idstring required

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

is_inlineboolean

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

in_trashboolean

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

is_lockedboolean

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

show_data_source_titleboolean

Whether to show the data source title above the database's views. Matches the Show data source title toggle in the Notion app. If not provided, the setting will not be updated.

Example request

{
  "title": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "description": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "icon": {
    "emoji": "😀"
  }
}

Response

OR

Example response

{
  "title": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "description": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "icon": {
    "emoji": "😀"
  }
}

Changes

  • c3aed1353a33Revision changes
    • info

      added the new optional request property

    • info

      added the required property //// to the response with the status

  • 86a6ebe86320Revision changes
    • info

      added the required property //// to the response with the status