Retrieve a database

curl https://api.bottari.ai/v1/databases/exampleDb001 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "database",
  "id": "exampleDb001",
  "title": [
    {
      "type": "text",
      "text": {
        "content": "Orders",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "Orders",
      "href": null
    }
  ],
  "description": [],
  "parent": {
    "type": "workspace",
    "workspace": true
  },
  "is_inline": false,
  "in_trash": false,
  "is_locked": false,
  "database_type": null,
  "show_data_source_title": false,
  "created_time": "2026-01-10T01:00:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "data_sources": [
    {
      "id": "exampleDb001",
      "name": "Orders"
    }
  ],
  "icon": null,
  "cover": null,
  "url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find database with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

databases

{id}

curl https://api.bottari.ai/v1/databases/exampleDb001 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "database",
  "id": "exampleDb001",
  "title": [
    {
      "type": "text",
      "text": {
        "content": "Orders",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "Orders",
      "href": null
    }
  ],
  "description": [],
  "parent": {
    "type": "workspace",
    "workspace": true
  },
  "is_inline": false,
  "in_trash": false,
  "is_locked": false,
  "database_type": null,
  "show_data_source_title": false,
  "created_time": "2026-01-10T01:00:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "data_sources": [
    {
      "id": "exampleDb001",
      "name": "Orders"
    }
  ],
  "icon": null,
  "cover": null,
  "url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find database with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads a database’s name, parent, icon, and cover. For property definitions, use Retrieve a data source. A Bottari database always has one data source, with the same ID. A trashed database can still be read while it’s connected, and in_trash is true.

string

required

Bearer <token>. See Tokens.

string

Optional. Only 2026-03-11 is accepted. Without it, the current version is used. A different value returns 400.

string

required

The database ID.

string

The database ID.

object[]

The name, as rich text items.

object[]

The description, as rich text items.

object

{ "type": "page_id", "page_id": "..." } for an inline database, otherwise { "type": "workspace", "workspace": true }.

boolean

true for an inline database.

boolean

true if it’s in the trash, including an inline database in a trashed document.

boolean

true if it’s locked.

object[]

Always one item, whose id matches the database ID.

string | null

The address that opens it in the app.

null

Always null.

Errors

Status	`code`	Cause
404	`object_not_found`	The database doesn’t exist or isn’t connected.

See Common rules for shared errors.

curl https://api.bottari.ai/v1/databases/exampleDb001 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "database",
  "id": "exampleDb001",
  "title": [
    {
      "type": "text",
      "text": {
        "content": "Orders",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "Orders",
      "href": null
    }
  ],
  "description": [],
  "parent": {
    "type": "workspace",
    "workspace": true
  },
  "is_inline": false,
  "in_trash": false,
  "is_locked": false,
  "database_type": null,
  "show_data_source_title": false,
  "created_time": "2026-01-10T01:00:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "data_sources": [
    {
      "id": "exampleDb001",
      "name": "Orders"
    }
  ],
  "icon": null,
  "cover": null,
  "url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find database with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Errors

​Errors

Errors