Database
Database objects describe the property schema of a database in Notion. Pages are the items (or children) in a database. Page property values must conform to the property objects laid out in the parent database object.
All databases
📘
Properties marked with an * are available to integrations with any capabilities. Other properties require read content capabilities in order to be returned from the Notion API. For more information on integration capabilities, see the capabilities guide.
| Field | Type | Description | Example value |
|---|---|---|---|
object* |
string |
Always "database". |
"database" |
id* |
string (UUID) |
Unique identifier for the database. | "2f26ee68-df30-4251-aad4-8ddc420cba3d" |
created_time |
string (ISO 8601 date and time) |
Date and time when this database was created. Formatted as an ISO 8601 date time string. | "2020-03-17T19:10:04.968Z" |
created_by |
Partial User | User who created the database. | {"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"} |
last_edited_time |
string (ISO 8601 date and time) |
Date and time when this database was updated. Formatted as an ISO 8601 date time string. | "2020-03-17T21:49:37.913Z" |
last_edited_by |
Partial User | User who last edited the database. | {"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"} |
title |
array of rich text objects | Name of the database as it appears in Notion. See rich text object) for a breakdown of the properties. | "title": [ { "type": "text", "text": { "content": "Can I create a URL property", "link": null }, "annotations": { "bold": false, "italic": false, "strikethrough": false, "underline": false, "code": false, "color": "default" }, "plain_text": "Can I create a URL property", "href": null } ] |
description |
array of rich text objects | Description of the database as it appears in Notion. See rich text object) for a breakdown of the properties. | |
icon |
File Object or Emoji object | Page icon. | |
cover |
File object (only type of "external" is supported currently) |
Page cover image. | |
properties* |
object |
Schema of properties for the database as they appear in Notion. key string The name of the property as it appears in Notion. value object A Property object. |
|
parent |
object |
Information about the database's parent. See Parent object. | { "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" } |
url |
string |
The URL of the Notion database. | "https://www.notion.so/668d797c76fa49349b05ad288df2d136" |
archived |
boolean |
The archived status of the database. | false |
is_inline |
boolean |
Has the value true if the database appears in the page as an inline block. Otherwise has the value false if the database appears as a child page. |
false |
Last modified: 2 years ago