apiwatch

All changes / Notion

Silent rest

Data source property updates now keep omitted description and select/multi_select options, and match option names case-insensitively

Took effect · Update a data source (PATCH /v1/data_sources/{data_source_id}, notion.dataSources.update) — property and option schema updates

Reviewed against the vendor source on Oct 12, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

As of October 9, 2026, Update a data source keeps a property's existing description when the request omits it, for every property type and when the type changes; send null to clear it. The same rule applies to an option's own description. Omitting options on a select or multi_select update now keeps the current options. Option names match existing options without regard to case, so sending "high" keeps the existing "High" option and its ID instead of replacing it; the API does not rename existing options. Changing the color of an existing select, multi_select, or status option now works instead of returning validation_error. Requests that omit description or options, or send a case-variant option name, now keep the existing values with no error.

Silent: No error. Behavior, results, or cost change quietly.

What to do

Send description null explicitly to clear a property or option description. To change a select or multi_select option list, send options with the complete list you want to keep; options left out of that list are removed. Don't rely on a differently cased name to add a new option; it now matches the existing one, and existing options can only be renamed in Notion.

Strings to search for

dataSources.update

Counts only in files that mention notion + properties.

Source

https://developers.notion.com/page/changelog