Data sources

Update a data source

Changed on
patch/v1/data_sources/{data_source_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/data_sources/{data_source_id}
  • Auth
    HTTP bearer

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": {
    "emoji": "😀"
  }
}

Response

OR

Example response

{
  "title": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "description": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ],
  "icon": {
    "emoji": "😀"
  }
}

Changes

  • 52686c6832a8Revision changes
    • info

      added the required property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status

  • 981cafc786b6Revision changes
    • info

      added the required property ///////// to the response with the status

    • info

      added the required property ///////// to the response with the status