Sign in

v3

latestOpenAPI 3.1.02026-07-31495191.1 MB
Data sources

Update a data source

patch/v1/data_sources/{data_source_id}

Path parameters

data_source_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

propertiesobject

The property schema of the data source. The keys are property names or IDs, and the values are property configuration objects. Properties set to null will be removed.

in_trashboolean

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

Example request

{
  "title": [
    {
      "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"
    }
  }
}