Skip to main content
PATCH
/
v1
/
data_sources
/
{data_source_id}
Update a data source
curl --request PATCH \
  --url https://api.notion.com/v1/data_sources/{data_source_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "title": [
    {
      "text": {
        "content": "<string>",
        "link": {
          "url": "<string>"
        }
      },
      "annotations": {
        "bold": true,
        "italic": true,
        "strikethrough": true,
        "underline": true,
        "code": true,
        "color": "default"
      },
      "type": "<string>"
    }
  ],
  "icon": {
    "file_upload": {
      "id": "<string>"
    },
    "type": "<string>"
  },
  "properties": {},
  "in_trash": true,
  "archived": true,
  "parent": {
    "database_id": "<string>",
    "type": "<string>"
  }
}
'
{
  "object": "<unknown>",
  "message": "<string>",
  "code": "invalid_json",
  "status": "<unknown>",
  "additional_data": {}
}
Updates the data source object — the properties, title, description, or whether it’s in the trash — of a specified data source under a database. Returns the updated data source object. Use the parent parameter to move the data source to a different database_id. If you do so, any existing views that refer to the data source in the current database continue to exist, but become linked views. A new standard “table” view for the moved data source is created under the new (destination) database. Use the Notion app to make any further changes to the views; managing views using the API is not currently supported. Data source properties represent the columns (or schema) of a data source. To update the properties of a data source, use the properties body param with this endpoint. Learn more about data source properties in the data source properties and Update data source properties docs. To update a relation data source property, share the related database with the integration. Learn more about relations in the data source properties page. For an overview of how to use the REST API with databases, refer to the Working with databases guide.

​
How data sources property type changes work

All properties in pages are stored as rich text. Notion will convert that rich text based on the types defined in a data source’s schema. When a type is changed using the API, the data will continue to be available, it is just presented differently. For example, a multi select property value is represented as a comma-separated list of strings (eg. “1, 2, 3”) and a people property value is represented as a comma-separated list of IDs. These are compatible and the type can be converted. Note: Not all type changes work. In some cases data will no longer be returned, such as people type → file type.

​
Interacting with data source rows

This endpoint cannot be used to update data source rows. To update the properties of a data source row — rather than a column — use the Update page properties endpoint. To add a new row to a database, use the Create a page endpoint. Developers are encouraged to keep their data source schema size to a maximum of 50KB. To stay within this schema size limit, the number of properties (or columns) added to a data source should be managed. Data source schema updates that are too large will be blocked by the REST API to help developers keep their data source queries performant.

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
The following data source properties cannot be updated via the API:
Data source relations must be shared with your integrationTo update a data source relation property, the related database must also be shared with your integration.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Path Parameters

​
data_source_id
string
required

ID of a Notion data source.

Body

application/json
​
title
object[]

Title of data source as it appears in Notion.

Maximum array length: 100
​
icon
object

Page icon.

​
properties
object

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_trash
boolean

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

​
archived
boolean

Whether the database should be moved to or from the trash. If not provided, the trash status will not be updated. Equivalent to in_trash.

​
parent
object

The parent of the data source, when moving it to a different database. If not provided, the parent will not be updated.

Response

​
object
any
required
​
message
string
required
​
code
enum<string>
required
Available options:
invalid_json,
invalid_request_url,
invalid_request,
missing_version,
validation_error
​
status
any
required
​
additional_data
object