Update a database

{
  "Result": {
    "value": "{\n\t\"object\": \"database\",\n\t\"id\": \"248104cd-477e-80fd-b757-e945d38000bd\",\n\t\"title\": [\n\t\t{\n\t\t\t\"type\": \"text\",\n\t\t\t\"text\": {\n\t\t\t\t\"content\": \"My Task Tracker\",\n\t\t\t\t\"link\": null\n\t\t\t},\n\t\t\t\"annotations\": {\n\t\t\t\t\"bold\": false,\n\t\t\t\t\"italic\": false,\n\t\t\t\t\"strikethrough\": false,\n\t\t\t\t\"underline\": false,\n\t\t\t\t\"code\": false,\n\t\t\t\t\"color\": \"default\"\n\t\t\t},\n\t\t\t\"plain_text\": \"My Task Tracker\",\n\t\t\t\"href\": null\n\t\t}\n\t],\n\t\"parent\": {\n\t\t\"type\": \"page_id\",\n\t\t\"page_id\": \"255104cd-477e-808c-b279-d39ab803a7d2\"\n\t},\n\t\"is_inline\": false,\n  \"in_trash\": false,\n  \"is_locked\": false,\n\t\"created_time\": \"2025-08-07T10:11:07.504-07:00\",\n\t\"last_edited_time\": \"2025-08-10T15:53:11.386-07:00\",\n\t\"data_sources\": [\n\t\t{\n\t\t\t\"id\": \"248104cd-477e-80af-bc30-000bd28de8f9\",\n\t\t\t\"name\": \"My Task Tracker\"\n\t\t}\n\t],\n\t\"icon\": null,\n\t\"cover\": null,\n\t\"developer_survey\": \"https://example.com/xyz\",\n\t\"request_id\": \"2f788b44-abf3-4809-aa4c-dd40734fed0b\"\n}"
  }
}

Updates the attributes — the title, description, icon, or cover, etc. — of a specified database.

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.

Path parameters

database_idstringRequired

ID of a Notion database, a container for one or more data sources. This is a UUIDv4, with or without dashes.

Request

This endpoint expects an object.

parentobjectOptional

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

titlelist of objectsOptional

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

is_inlinebooleanOptional

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

iconobjectOptional

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

coverobjectOptional

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

in_trashbooleanOptional

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

is_lockedbooleanOptional

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

Response

200

objectstringOptional

idstringOptional

titlelist of objectsOptional

parentobjectOptional

is_inlinebooleanOptionalDefaults to true

in_trashbooleanOptionalDefaults to true

is_lockedbooleanOptionalDefaults to true

created_timestringOptional

last_edited_timestringOptional

data_sourceslist of objectsOptional

iconanyOptional

coveranyOptional

developer_surveystringOptional

request_idstringOptional

Errors

400

Bad Request Error

Path parameters

Headers

Request

Response

Errors