5.0.0-preview-1.12.25.2025

🚀 Features

Data Sources API Support

• NEW: Complete Data Sources API implementation with full CRUD operations
  • Retrieve, create, update, and query data sources
  • List data source templates functionality
  • Support for data source property configurations
• NEW: Enhanced search functionality now supports data sources alongside pages and databases

Notion API Version Update

• NEW: Support for Notion API version 2025-09-03 (latest)
• Updated default API version in Constants to 2025-09-03

File Upload Enhancements

• Improved file upload models and request handling
• Enhanced page cover support with new request models:
  • ExternalPageCoverRequest
  • FileUploadPageCoverRequest
• Enhanced page icon models with better type consistency

Database and Page Improvements

• NEW: Database update functionality with new request models
• Enhanced page creation with improved parent request handling
• Better timezone support in DateCustomConverter for improved serialization/deserialization

💥 Breaking Changes

Database API Changes

• REMOVED: QueryAsync method from IDatabasesClient
  • Database querying functionality has been consolidated into the Search API
  • Use ISearchClient.SearchAsync() instead for querying pages and databases
• REMOVED: DatabasesQueryParameters and related query classes

File Upload API Changes

• BREAKING: IFileUploadsClient methods now return FileUpload directly instead of wrapper response classes
• REMOVED: Redundant response wrapper classes for file uploads
• RENAMED: FileObjectResponse → FileUpload

Model and Interface Refactoring

• BREAKING: Consolidated parent interfaces:
  • Removed IDatabaseParent, IParent interfaces
  • Introduced unified parent request models: PageParentRequest, DatabaseParentRequest
  • Refactored to use IParentOfPage, IParentOfBlock, IParentOfDatabase interfaces
• BREAKING: Data source models refactored:
  • DataSourceResponse → DataSource
  • PropertyConfigurationRequest → DataSourceConfigRequest
  • Removed "Response" prefix from various DataSource property config models
• REMOVED: ParentType enum in favor of string constants
• REMOVED: IWikiDatabase interface and PagePropertyOnId class (no longer needed)

Page and Block Changes

• BREAKING: Page cover and icon models refactored for better type consistency
  • Use IPageCoverRequest and IPageIconRequest interfaces for requests
  • Updated page creation parameters to use new request models

🏗️ Technical Improvements

Framework and Dependencies

• UPDATED: Target framework to .NET 10.0 for integration and unit test projects
• UPDATED: CI build to use .NET 10.0.x

Code Quality

• IMPROVED: Removed unnecessary using directives across multiple files
• FIXED: Code factor warnings and linter issues
• ENHANCED: Better cancellation token parameter documentation
• ADDED: cSpell configuration for custom words

Model Organization

• REORGANIZED: Moved models to appropriate folders for better structure:
  • FileUpload models moved to common models folder
  • DataSource models properly organized under Models/DataSource/
  • Request models better organized under appropriate domains

🔧 Maintenance & CI

Build System

• UPDATED: CI workflows to support .NET 10.0.x
• IMPROVED: Build and test reliability

Code Structure

• REFACTORED: Extensive cleanup of duplicate and redundant classes
• IMPROVED: Interface consistency across different API clients
• ENHANCED: Request/response model organization and naming conventions

📚 Documentation

• UPDATED: README files with current API examples
• UPDATED: Documentation to reflect Search API for database querying
• ADDED: Data Sources API documentation with usage examples
• UPDATED: Version compatibility matrix

🚀 Looking for a Maintainer

If you’re passionate about this project and want to help shape its future, join the discussion here: 🔗 Maintainer Discussion

Don’t hesitate to open an issue if you’re interested in becoming a maintainer.

🪔 Merry Christmas and Happy New Year!

May this festive season fill your home with joy, your heart with peace, and your days with love. Wishing you health, happiness, and success in the year ahead. ✨

Note: This is a preview release of v5.0.0. Some APIs may still be subject to change before the final release.

Let’s continue building and sharing light — both in code and community. 💛

4.4.1 release

Changes

• fix query database under wiki page (#499) @kosaku-hayashi
• add VerificationProperty (#497) @kosaku-hayashi

4.4.0 release - 🪔 Happy Diwali!

🚀 Features

• Added support for Retrieve a file upload API (#494) — @KoditkarVedant
• Added support for List file uploads API (#493) — @KoditkarVedant
• Added support for Complete file upload API endpoint (#492) — @KoditkarVedant
• Added support for Send file upload API (#488) — @KoditkarVedant
• Added unit tests for Create File Upload API (#490) — @KoditkarVedant
• Added support for Create file upload API endpoint (#487) — @KoditkarVedant
• Added support for Refresh token endpoint (#485) — @KoditkarVedant
• Parsed refresh token from Create Token response (#484) — @KoditkarVedant
• Added support for Introspect token API (#474) — @KoditkarVedant
• Introduced Revoke functionality (#456) — @Mr-Bally

🐛 Bug Fixes

• Fixed: Added support to pass Basic Authentication for the authentication endpoint (#473) — @KoditkarVedant
• Fixed: Deserialization issue for default_background (#466) — @kkuepper

🧰 Maintenance

• Updated documentation with newly supported API endpoints (#495) — @KoditkarVedant
• Removed LGTM YAML and links 🗑️ (#459) — @KoditkarVedant
• Added a workflow to greet first-time contributors (#455) — @KoditkarVedant
• Updated dependencies via Dependabot:
  • Microsoft.VisualStudio.VsixColorCompiler: 16.0.0 → 17.11.35325.10 (#448)
  • xunit.runner.visualstudio: 2.4.3 → 3.0.2 (#444)
  • coverlet.collector: 1.3.0 → 6.0.4 (#443)
  • Microsoft.NET.Test.Sdk: 16.7.1 → 17.13.0 (#440)
  • Microsoft.SourceLink.GitHub: 1.1.1 → 8.0.0 (#439)

📈 Milestone

🎉 We’ve reached 327.9K downloads! 🥳
A heartfelt thank you to everyone for the continued love and support for this SDK. It’s been a while since our last release, and we’re thrilled to bring you this update packed with new features and improvements.

🙌 Special Thanks

Huge appreciation to our amazing contributors for this release:
@Mr-Bally, and @kkuepper — for your valuable contributions — your work keeps this project shining! 💪

Everyone is welcome to contribute — we’d love to hear your ideas! Feel free to open an issue or start a discussion anytime.

🚀 Looking for a Maintainer

If you’re passionate about this project and want to help shape its future, join the discussion here: 🔗 Maintainer Discussion

Don’t hesitate to open an issue if you’re interested in becoming a maintainer.

🪔 Happy Diwali!

As we light up new features and fixes, we wish you and your loved ones a bright and joyous Diwali filled with happiness, prosperity, and innovation! ✨

Let’s continue building and sharing light — both in code and community. 💛

4.4.0-preview-1.9.16.2025

Changes

• Can't deserialize default_background #466 @kkuepper
• Remove lgtm yaml and links 🗑️ (#459) @KoditkarVedant
• Added revoke functionality (#456) @Mr-Bally
• deps: bump Microsoft.VisualStudio.VsixColorCompiler from 16.0.0 to 17.11.35325.10 (#448) @dependabot
• deps: bump xunit.runner.visualstudio from 2.4.3 to 3.0.2 (#444) @dependabot
• deps: bump coverlet.collector from 1.3.0 to 6.0.4 (#443) @dependabot
• deps: bump Microsoft.NET.Test.Sdk from 16.7.1 to 17.13.0 (#440) @dependabot
• deps: bump Microsoft.SourceLink.GitHub from 1.1.1 to 8.0.0 (#439) @dependabot

🧰 Maintenance

• Add workflow to greet first-time contributors (#455) @KoditkarVedant

4.3.0 release

🚀 Features

• Add support for reading and writing Name & Caption properties to file blocks (#436) @KoditkarVedant
• Throw error if database id was not provided (#432) @KoditkarVedant
• Use DateTimeOffset instead of DateTime for DatePropertyValue (#422) @KoditkarVedant
• Support "bad_gateway" error code (#421) @kosaku-hayashi
• Added support for button properties (#418) @kosaku-hayashi
• Add support to read/write file name for file blocks (#411) @Kuzmanov
• Removed 'archived' property and added 'in_trash' property (#417) @kosaku-hayashi
• Add separate request model for blocks API (#401) @KoditkarVedant (BREAKING CHANGE)
• Add type-specific pagination information (#395) @KoditkarVedant
• Add missing property in paginated response (#393) @kashifsoofi
• Add support for create token endpoint (#392) @KoditkarVedant
• Add support for querying wiki databases (#391) @KoditkarVedant

🐛 Bug Fixes

• Fix date mention creation and deserialization (#434) @KoditkarVedant
• Fix date custom converter to serialize and deserialize ISO 8601 date and time (#433) @KoditkarVedant
• Fix serialization issues (#429) @mzahor
• Fix typo: GetewayTimeout → GatewayTimeout (#409) @Kuzmanov
• Fix broken database relation request parameters (#404) @gehongyan
• Allow setting properties to null (#427) @mzahor
• Add wrapper class to avoid sending block ID as part of request body (#399) @KoditkarVedant

🧰 Maintenance

• Enable Dependabot (#438) @KoditkarVedant
• Adjust breaking integration tests (#400) @KoditkarVedant
• Integrate release drafter (#389) @KoditkarVedant

🎉🎉🎉

---

🎉 We've hit 263.2K downloads! 🥳

A huge thank you to everyone for the continued love and support for this SDK. It's been a little while since our last release, and I'm excited to share this update with you all.

Special thanks to @kosaku-hayashi, @Kuzmanov, @kashifsoofi, @mzahor, and @gehongyan for their contributions — your efforts are deeply appreciated!

Everyone is welcome to contribute, and I'd love to hear your ideas. Feel free to open an issue or start a discussion anytime.

---

🚀 Looking for a maintainer!
If you're passionate about this project and want to help shape its future, check out the discussion here:
https://github.com/notion-dotnet/notion-sdk-net/discussions/349

Don't hesitate to open an issue if you're interested in becoming a maintainer.

4.2.0 release

Enhancements/Tech ✨

• #253 Support API's to return the response headers
• #358 Add support to pass paginated query params for Users.ListAsync() API
• #361 Add support for SyncedBlock
• #362 Expose Retry-After value into the exception
• #366 Add Support for UniqueId Property
• #370 Add support for filter_properties
• #371 A support for after parameter to the Append block children API
• #372 Add support for public_url on Page and Database object
• #374 Add support for Verification Property
• #373 Support New Notion Error Codes

Bug Fixes 🐛

• #365 Body validation fail when using TimestampLastEditedTimeFilter in DB query.

CI/Test 👷🏼

• N/A

Documentations 📝

• N/A

🎉 🎉 🎉

---

We have crossed 109.8K downloads 🥳

Thank you all for the love and support you are showing on this SDK. It's been some time we had our last release. I would like to thank you @Dmitry-VF, @RandomUser14, @Poltuu and @HermanSchoenfeld for their contribution. Everyone are welcome to contribute. I'm happy to hear any idea you have - fill free to open issue or discussion.

---

I'm looking for maintainer for the project - #349 feel free to open an issue if you are interested to become a maintainer.

🎉 🎉 🎉

4.1.0 release

Enhancements/Tech ✨

• #353/#355 Allow null value for SelectPropertyValue.Select property
• #342 Follow common API conventions
• #340 Fix Typos (@sotiriszogos)
• #335 Setup JetBrains Cleanup Code
• #332 Update to latest version of Microsoft.SourceLink.GitHub (@vinibeloni)

Bug Fixes 🐛

• #347 Incorrect Type: TableBlock.TableInfo.Children should be IEnumerable

CI/Test 👷🏼

• #336 Add lint in CI build workflow

Documentations 📝

• Updated readme with the information of default Notion-Version per package version.

We have crossed 100⭐ 🤩 🤩

Thank you all for the love and support you are showing on this SDK. It's been some time we had our last release. I would like to thank you @sotiriszogos and @vinibeloni for their contribution. Everyone are welcome to contribute. I'm happy to hear any idea you have - fill free to open issue or discussion.

🎉 🎉 🎉

4.0.0 release

Enhancements/Tech ✨

• #257 Add support for Notion-Version 2022-06-28
  • #258 Page properties must be retrieved using the page properties endpoint
  • #259 Parents are now always direct parents; a parent field has been added to block
  • #298 Set default Notion-Version to 2022-06-28
  • #260 Database relations have a type of single_property and dual_property
• #310 Add support for Comments API
• #319 Version 2022-06-28 includes page property types and values
• #323 Add support for link_preview block type
• #329 Add support for StatusFilter

Bug Fixes 🐛

• #309 Number property causes exception in RetrievePagePropertyItem
• #317 RetrievePagePropertyItem does not return any data for RichText properties (v4 preview)
• #325 RetrievePagePropertyItem for status property failed

CI/Test 👷🏼

• Add Integration tests for bug fixes

Documentations 📝

• Updated readme with the information of default Notion-Version per package version.

🎉 🎉 🎉

4.0.0-preview-6.9.19.2022

Enhancements/Tech ✨

• N/A

Bug Fixes 🐛

• #325 RetrievePagePropertyItem for status property failed

CI/Test 👷🏼

• N/A

Documentations 📝

• N/A

🎉 🎉 🎉

4.0.0-preview-5.9.15.2022

Enhancements/Tech ✨

• #323 Add support for link_preview block type

Bug Fixes 🐛

• N/A

CI/Test 👷🏼

• N/A

Documentations 📝

• N/A

🎉 🎉 🎉