Update a data source

TypeScript SDK

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.dataSources.update({
  data_source_id: "d9824bdc-8445-4327-be8b-5b47500af6ce",
  title: [{ text: { content: "Updated Data Source Name" } }]
})

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": "https://www.notion.com"
        }
      },
      "annotations": {
        "bold": true,
        "italic": true,
        "strikethrough": true,
        "underline": true,
        "code": true
      },
      "type": "text"
    }
  ],
  "icon": {
    "file_upload": {
      "id": "<string>"
    },
    "type": "file_upload"
  },
  "properties": {},
  "in_trash": true
}
'

import requests

url = "https://api.notion.com/v1/data_sources/{data_source_id}"

payload = {
    "title": [
        {
            "text": {
                "content": "<string>",
                "link": { "url": "https://www.notion.com" }
            },
            "annotations": {
                "bold": True,
                "italic": True,
                "strikethrough": True,
                "underline": True,
                "code": True
            },
            "type": "text"
        }
    ],
    "icon": {
        "file_upload": { "id": "<string>" },
        "type": "file_upload"
    },
    "properties": {},
    "in_trash": True
}
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/v1/data_sources/{data_source_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => [
        [
                'text' => [
                                'content' => '<string>',
                                'link' => [
                                                                'url' => 'https://www.notion.com'
                                ]
                ],
                'annotations' => [
                                'bold' => true,
                                'italic' => true,
                                'strikethrough' => true,
                                'underline' => true,
                                'code' => true
                ],
                'type' => 'text'
        ]
    ],
    'icon' => [
        'file_upload' => [
                'id' => '<string>'
        ],
        'type' => 'file_upload'
    ],
    'properties' => [
        
    ],
    'in_trash' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/v1/data_sources/{data_source_id}"

	payload := strings.NewReader("{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.notion.com/v1/data_sources/{data_source_id}")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/v1/data_sources/{data_source_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}"

response = http.request(request)
puts response.read_body

{
  "object": "data_source",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "properties": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "invalid_json",
  "status": 400,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "unauthorized",
  "status": 401,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "restricted_resource",
  "status": 403,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "object_not_found",
  "status": 404,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "row_limit_exceeded",
  "status": 406,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "conflict_error",
  "status": 409,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "rate_limited",
  "status": 429,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "internal_server_error",
  "status": 500,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "service_unavailable",
  "status": 503,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "gateway_timeout",
  "status": 504,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "service_overload",
  "status": 529,
  "additional_data": {}
}

PATCH

data_sources

{data_source_id}

TypeScript SDK

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.dataSources.update({
  data_source_id: "d9824bdc-8445-4327-be8b-5b47500af6ce",
  title: [{ text: { content: "Updated Data Source Name" } }]
})

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": "https://www.notion.com"
        }
      },
      "annotations": {
        "bold": true,
        "italic": true,
        "strikethrough": true,
        "underline": true,
        "code": true
      },
      "type": "text"
    }
  ],
  "icon": {
    "file_upload": {
      "id": "<string>"
    },
    "type": "file_upload"
  },
  "properties": {},
  "in_trash": true
}
'

import requests

url = "https://api.notion.com/v1/data_sources/{data_source_id}"

payload = {
    "title": [
        {
            "text": {
                "content": "<string>",
                "link": { "url": "https://www.notion.com" }
            },
            "annotations": {
                "bold": True,
                "italic": True,
                "strikethrough": True,
                "underline": True,
                "code": True
            },
            "type": "text"
        }
    ],
    "icon": {
        "file_upload": { "id": "<string>" },
        "type": "file_upload"
    },
    "properties": {},
    "in_trash": True
}
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/v1/data_sources/{data_source_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => [
        [
                'text' => [
                                'content' => '<string>',
                                'link' => [
                                                                'url' => 'https://www.notion.com'
                                ]
                ],
                'annotations' => [
                                'bold' => true,
                                'italic' => true,
                                'strikethrough' => true,
                                'underline' => true,
                                'code' => true
                ],
                'type' => 'text'
        ]
    ],
    'icon' => [
        'file_upload' => [
                'id' => '<string>'
        ],
        'type' => 'file_upload'
    ],
    'properties' => [
        
    ],
    'in_trash' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/v1/data_sources/{data_source_id}"

	payload := strings.NewReader("{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.notion.com/v1/data_sources/{data_source_id}")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/v1/data_sources/{data_source_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": [\n    {\n      \"text\": {\n        \"content\": \"<string>\",\n        \"link\": {\n          \"url\": \"https://www.notion.com\"\n        }\n      },\n      \"annotations\": {\n        \"bold\": true,\n        \"italic\": true,\n        \"strikethrough\": true,\n        \"underline\": true,\n        \"code\": true\n      },\n      \"type\": \"text\"\n    }\n  ],\n  \"icon\": {\n    \"file_upload\": {\n      \"id\": \"<string>\"\n    },\n    \"type\": \"file_upload\"\n  },\n  \"properties\": {},\n  \"in_trash\": true\n}"

response = http.request(request)
puts response.read_body

{
  "object": "data_source",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "properties": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "invalid_json",
  "status": 400,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "unauthorized",
  "status": 401,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "restricted_resource",
  "status": 403,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "object_not_found",
  "status": 404,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "row_limit_exceeded",
  "status": 406,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "conflict_error",
  "status": 409,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "rate_limited",
  "status": 429,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "internal_server_error",
  "status": 500,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "service_unavailable",
  "status": 503,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "gateway_timeout",
  "status": 504,
  "additional_data": {}
}

{
  "object": "error",
  "message": "<string>",
  "code": "service_overload",
  "status": 529,
  "additional_data": {}
}

Updates a data source’s name, icon, schema, parent, or trash status. Returns the updated data source object. Use properties to change the schema. See Update data source properties for request bodies and Property schemas for each type’s settings.

Parent changes

Set parent.database_id to move the data source to another database. Existing views in the original database become linked views. Notion creates a table view in the destination database. See Views for the view API.

How data sources property type changes work

Changing a property’s type changes how Notion reads its existing values. Some values cannot be read in the new type. Test the conversion before applying it to data you need. The Name property (title) cannot be removed or converted. Other properties cannot become title. You can add or rename a Place property, but you cannot convert a property to or from place. Synced data sources have additional restrictions.

Interacting with data source rows

This endpoint changes the schema for all pages in the data source. To change one page’s values, use Update page. To add a page, use Create page.

Recommended data source schema size limit

Keep the schema within 50 KB. Schema updates that are too large return validation_error. The error identifies the largest property by name, ID, and byte size so you can reduce it. Large option lists and long property descriptions contribute to schema size. Remove unused settings or shorten descriptions before retrying.

Access and errors

The connection needs update content capabilities and access to the data source. Relations and rollups also need access to the related database. A missing data source or missing access returns 404. See Status codes for other errors.

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 2026-03-11.

Available options:

2026-03-11

Path Parameters

data_source_id

string

required

ID of a Notion data source.

Body

application/json

title

(Text · object | Mention · object | Equation · object)[]

Title of data source as it appears in Notion.

Maximum array length: 100

Text
Mention
Equation

Show child attributes

icon

File Upload · object

Data source icon.

File Upload
Emoji
External
Custom Emoji
Icon

Show child attributes

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.

Show child attributes

in_trash

boolean

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

parent

Database Id · object

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

Show child attributes

Response

Option 1
Option 2

object

string

required

The data source object type name.

Allowed value: "data_source"

string<uuid>

required

The ID of the data source.

properties

object

required

The properties schema of the data source.

Show child attributes

Notion API

Objects

Endpoints

Webhook events

Parent changes

How data sources property type changes work

Interacting with data source rows

Recommended data source schema size limit

Access and errors

Authorizations

Headers

Path Parameters

Body

Response

​Parent changes

​How data sources property type changes work

​Interacting with data source rows

​Recommended data source schema size limit

​Access and errors

Authorizations

Headers

Path Parameters

Body

Response

Parent changes

How data sources property type changes work

Interacting with data source rows

Recommended data source schema size limit

Access and errors