notion_update_database
Modify Notion database titles, descriptions, and properties using rich text formatting and structured data. Specify database ID and desired changes for updates.
Instructions
Update a database in Notion
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| database_id | Yes | The ID of the database to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| description | No | An array of rich text objects that represents the description of the database that is displayed in the Notion UI. | |
| format | No | Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it. | markdown |
| properties | No | The properties of a database to be changed in the request, in the form of a JSON object. | |
| title | No | An array of rich text objects that represents the title of the database that is displayed in the Notion UI. |
Input Schema (JSON Schema)
{
"properties": {
"database_id": {
"description": "The ID of the database to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
},
"description": {
"description": "An array of rich text objects that represents the description of the database that is displayed in the Notion UI.",
"items": {
"description": "A rich text object.",
"properties": {
"annotations": {
"description": "Styling information for the text. By default, give nothing for default text.",
"properties": {
"bold": {
"type": "boolean"
},
"code": {
"type": "boolean"
},
"color": {
"description": "Color for the text.",
"enum": [
"default",
"blue",
"blue_background",
"brown",
"brown_background",
"gray",
"gray_background",
"green",
"green_background",
"orange",
"orange_background",
"pink",
"pink_background",
"purple",
"purple_background",
"red",
"red_background",
"yellow",
"yellow_background"
],
"type": "string"
},
"italic": {
"type": "boolean"
},
"strikethrough": {
"type": "boolean"
},
"underline": {
"type": "boolean"
}
},
"type": "object"
},
"equation": {
"description": "Equation object if type is 'equation'. Represents an inline LaTeX equation.",
"properties": {
"expression": {
"description": "LaTeX string representing the inline equation.",
"type": "string"
}
},
"required": [
"expression"
],
"type": "object"
},
"href": {
"description": "The URL of any link or mention in this text, if any. Do NOT provide a NULL value, just ignore this field if there is no link or mention.",
"type": "string"
},
"mention": {
"description": "Mention object if type is 'mention'. Represents an inline mention of a database, date, link preview, page, template mention, or user.",
"oneOf": [
{
"required": [
"database"
]
},
{
"required": [
"date"
]
},
{
"required": [
"link_preview"
]
},
{
"required": [
"page"
]
},
{
"required": [
"template_mention"
]
},
{
"required": [
"user"
]
}
],
"properties": {
"database": {
"description": "Database mention object. Contains a database reference with an 'id' field.",
"properties": {
"id": {
"description": "The ID of the mentioned database.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"date": {
"description": "Date mention object, containing a date property value object.",
"properties": {
"end": {
"description": "An ISO 8601 formatted end date or date-time, or null if not a range.",
"type": [
"string",
"null"
]
},
"start": {
"description": "An ISO 8601 formatted start date or date-time.",
"type": "string"
},
"time_zone": {
"description": "Time zone information for start and end. If null, times are in UTC.",
"type": [
"string",
"null"
]
}
},
"required": [
"start"
],
"type": "object"
},
"link_preview": {
"description": "Link Preview mention object, containing a URL for the link preview.",
"properties": {
"url": {
"description": "The URL for the link preview.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"page": {
"description": "Page mention object, containing a page reference with an 'id' field.",
"properties": {
"id": {
"description": "The ID of the mentioned page.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"template_mention": {
"description": "Template mention object, can be a template_mention_date or template_mention_user.",
"properties": {
"template_mention_date": {
"description": "For template_mention_date type, the date keyword.",
"enum": [
"today",
"now"
],
"type": "string"
},
"template_mention_user": {
"description": "For template_mention_user type, the user keyword.",
"enum": [
"me"
],
"type": "string"
},
"type": {
"description": "The template mention type.",
"enum": [
"template_mention_date",
"template_mention_user"
],
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "The type of the mention.",
"enum": [
"database",
"date",
"link_preview",
"page",
"template_mention",
"user"
],
"type": "string"
},
"user": {
"description": "User mention object, contains a user reference.",
"properties": {
"id": {
"description": "The ID of the user.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
},
"object": {
"description": "Should be 'user'.",
"enum": [
"user"
],
"type": "string"
}
},
"required": [
"object",
"id"
],
"type": "object"
}
},
"required": [
"type"
],
"type": "object"
},
"plain_text": {
"description": "The plain text without annotations.",
"type": "string"
},
"text": {
"description": "Object containing text content and optional link info. Required if type is 'text'.",
"properties": {
"content": {
"description": "The actual text content.",
"type": "string"
},
"link": {
"description": "Optional link object with a 'url' field. Do NOT provide a NULL value, just ignore this field no link.",
"properties": {
"url": {
"description": "The URL the text links to.",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": {
"description": "The type of this rich text object. Possible values: text, mention, equation.",
"enum": [
"text",
"mention",
"equation"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
},
"format": {
"default": "markdown",
"description": "Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.",
"enum": [
"json",
"markdown"
],
"type": "string"
},
"properties": {
"description": "The properties of a database to be changed in the request, in the form of a JSON object.",
"type": "object"
},
"title": {
"description": "An array of rich text objects that represents the title of the database that is displayed in the Notion UI.",
"items": {
"description": "A rich text object.",
"properties": {
"annotations": {
"description": "Styling information for the text. By default, give nothing for default text.",
"properties": {
"bold": {
"type": "boolean"
},
"code": {
"type": "boolean"
},
"color": {
"description": "Color for the text.",
"enum": [
"default",
"blue",
"blue_background",
"brown",
"brown_background",
"gray",
"gray_background",
"green",
"green_background",
"orange",
"orange_background",
"pink",
"pink_background",
"purple",
"purple_background",
"red",
"red_background",
"yellow",
"yellow_background"
],
"type": "string"
},
"italic": {
"type": "boolean"
},
"strikethrough": {
"type": "boolean"
},
"underline": {
"type": "boolean"
}
},
"type": "object"
},
"equation": {
"description": "Equation object if type is 'equation'. Represents an inline LaTeX equation.",
"properties": {
"expression": {
"description": "LaTeX string representing the inline equation.",
"type": "string"
}
},
"required": [
"expression"
],
"type": "object"
},
"href": {
"description": "The URL of any link or mention in this text, if any. Do NOT provide a NULL value, just ignore this field if there is no link or mention.",
"type": "string"
},
"mention": {
"description": "Mention object if type is 'mention'. Represents an inline mention of a database, date, link preview, page, template mention, or user.",
"oneOf": [
{
"required": [
"database"
]
},
{
"required": [
"date"
]
},
{
"required": [
"link_preview"
]
},
{
"required": [
"page"
]
},
{
"required": [
"template_mention"
]
},
{
"required": [
"user"
]
}
],
"properties": {
"database": {
"description": "Database mention object. Contains a database reference with an 'id' field.",
"properties": {
"id": {
"description": "The ID of the mentioned database.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"date": {
"description": "Date mention object, containing a date property value object.",
"properties": {
"end": {
"description": "An ISO 8601 formatted end date or date-time, or null if not a range.",
"type": [
"string",
"null"
]
},
"start": {
"description": "An ISO 8601 formatted start date or date-time.",
"type": "string"
},
"time_zone": {
"description": "Time zone information for start and end. If null, times are in UTC.",
"type": [
"string",
"null"
]
}
},
"required": [
"start"
],
"type": "object"
},
"link_preview": {
"description": "Link Preview mention object, containing a URL for the link preview.",
"properties": {
"url": {
"description": "The URL for the link preview.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"page": {
"description": "Page mention object, containing a page reference with an 'id' field.",
"properties": {
"id": {
"description": "The ID of the mentioned page.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"template_mention": {
"description": "Template mention object, can be a template_mention_date or template_mention_user.",
"properties": {
"template_mention_date": {
"description": "For template_mention_date type, the date keyword.",
"enum": [
"today",
"now"
],
"type": "string"
},
"template_mention_user": {
"description": "For template_mention_user type, the user keyword.",
"enum": [
"me"
],
"type": "string"
},
"type": {
"description": "The template mention type.",
"enum": [
"template_mention_date",
"template_mention_user"
],
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "The type of the mention.",
"enum": [
"database",
"date",
"link_preview",
"page",
"template_mention",
"user"
],
"type": "string"
},
"user": {
"description": "User mention object, contains a user reference.",
"properties": {
"id": {
"description": "The ID of the user.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).",
"type": "string"
},
"object": {
"description": "Should be 'user'.",
"enum": [
"user"
],
"type": "string"
}
},
"required": [
"object",
"id"
],
"type": "object"
}
},
"required": [
"type"
],
"type": "object"
},
"plain_text": {
"description": "The plain text without annotations.",
"type": "string"
},
"text": {
"description": "Object containing text content and optional link info. Required if type is 'text'.",
"properties": {
"content": {
"description": "The actual text content.",
"type": "string"
},
"link": {
"description": "Optional link object with a 'url' field. Do NOT provide a NULL value, just ignore this field no link.",
"properties": {
"url": {
"description": "The URL the text links to.",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": {
"description": "The type of this rich text object. Possible values: text, mention, equation.",
"enum": [
"text",
"mention",
"equation"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"database_id"
],
"type": "object"
}