Sign in

v1

latestOpenAPI 3.1.02026-07-2664485505.4 KB
Databases

Update a database

patch/v1/databases/{database_id}

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.

Example request

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

Response

OR

Example response

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