Support notion version 2025-09-03

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "cSpell.words": [
+        "Newtonsoft"
+    ]
+}

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -148,5 +148,15 @@ public static class FileUploadsApiUrls
             public static string List => "/v1/file_uploads";
             public static string Retrieve(IRetrieveFileUploadPathParameters pathParameters) => $"/v1/file_uploads/{pathParameters.FileUploadId}";
         }
+
+        public static class DataSourcesApiUrls
+        {
+            private const string BasePath = "/v1/data_sources";
+            public static string Retrieve(IRetrieveDataSourcePathParameters pathParameters) => $"{BasePath}/{pathParameters.DataSourceId}";
+            internal static string CreateDataSource() => BasePath;
+            internal static string Update(IUpdateDataSourcePathParameters pathParameters) => $"{BasePath}/{pathParameters.DataSourceId}";
+            internal static string ListDataSourceTemplates(IListDataSourceTemplatesPathParameters pathParameters) => $"/v1/data-sources/{pathParameters.DataSourceId}/templates";
+            internal static string Query(IQueryDataSourcePathParameters pathParameters) => $"{BasePath}/{pathParameters.DataSourceId}/query";
+        }
     }
 }

Src/Notion.Client/Api/Blocks/BlocksClient.cs

@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using static Notion.Client.ApiEndpoints;

Src/Notion.Client/Api/Blocks/RequestParams/BlocksUpdateParameters/UpdateBlocks/CalloutUpdateBlock.cs

@@ -14,7 +14,7 @@ public class Info
             public IEnumerable<RichTextBaseInput> RichText { get; set; }
 
             [JsonProperty("icon")]
-            public IPageIcon Icon { get; set; }
+            public IPageIconRequest Icon { get; set; }
         }
     }
 }

Src/Notion.Client/Api/Blocks/RequestParams/BlocksUpdateParameters/UpdateBlocks/LinkToPageUpdateBlock.cs

@@ -5,6 +5,6 @@ namespace Notion.Client
     public class LinkToPageUpdateBlock : UpdateBlock
     {
         [JsonProperty("link_to_page")]
-        public IPageParentInput LinkToPage { get; set; }
+        public ILinkToPage LinkToPage { get; set; }
     }
 }

Src/Notion.Client/Api/Comments/Create/CommentsClient.cs

@@ -5,11 +5,11 @@ namespace Notion.Client
 {
     public partial class CommentsClient
     {
-        public async Task<CreateCommentResponse> CreateAsync(CreateCommentParameters parameters, CancellationToken cancellationToken = default)
+        public async Task<Comment> CreateAsync(CreateCommentRequest parameters, CancellationToken cancellationToken = default)
         {
             var body = (ICreateCommentsBodyParameters)parameters;
 
-            return await _client.PostAsync<CreateCommentResponse>(
+            return await _client.PostAsync<Comment>(
                 ApiEndpoints.CommentsApiUrls.Create(),
                 body,
                 cancellationToken: cancellationToken

Src/Notion.Client/Api/Comments/Create/Request/CreateCommentRequest.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+
+namespace Notion.Client
+{
+    public class CreateCommentRequest : ICreateDiscussionCommentBodyParameters, ICreatePageCommentBodyParameters
+    {
+        public string DiscussionId { get; set; }
+
+        public IEnumerable<RichTextBaseInput> RichText { get; set; }
+
+        public ParentPageInput Parent { get; set; }
+
+        public static CreateCommentRequest CreatePageComment(
+            ParentPageInput parent,
+            IEnumerable<RichTextBaseInput> richText)
+        {
+            return new CreateCommentRequest
+            {
+                Parent = parent,
+                RichText = richText
+            };
+        }
+
+        public static CreateCommentRequest CreateDiscussionComment(
+            string discussionId,
+            IEnumerable<RichTextBaseInput> richText)
+        {
+            return new CreateCommentRequest
+            {
+                DiscussionId = discussionId,
+                RichText = richText
+            };
+        }
+    }
+}

Src/Notion.Client/Api/Comments/Create/Request/ICreateCommentsBodyParameters.cs

@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface ICreateCommentsBodyParameters
+    {
+        [JsonProperty("rich_text")]
+        public IEnumerable<RichTextBaseInput> RichText { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Create/Request/ICreateDiscussionCommentBodyParameters.cs

@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface ICreateDiscussionCommentBodyParameters : ICreateCommentsBodyParameters
+    {
+        [JsonProperty("discussion_id")]
+        public string DiscussionId { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/Create/Request/ICreatePageCommentBodyParameters.cs

@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface ICreatePageCommentBodyParameters : ICreateCommentsBodyParameters
+    {
+        [JsonProperty("parent")]
+        public ParentPageInput Parent { get; set; }
+    }
+}

Src/Notion.Client/Api/Comments/ICommentsClient.cs

@@ -5,8 +5,8 @@ namespace Notion.Client
 {
     public interface ICommentsClient
     {
-        Task<CreateCommentResponse> CreateAsync(CreateCommentParameters createCommentParameters, CancellationToken cancellationToken = default);
+        Task<Comment> CreateAsync(CreateCommentRequest createCommentParameters, CancellationToken cancellationToken = default);
 
-        Task<RetrieveCommentsResponse> RetrieveAsync(RetrieveCommentsParameters parameters, CancellationToken cancellationToken = default);
+        Task<RetrieveCommentsResponse> RetrieveAsync(RetrieveCommentsRequest parameters, CancellationToken cancellationToken = default);
     }
 }

Src/Notion.Client/Api/Comments/Retrieve/CommentsClient.cs

@@ -8,7 +8,7 @@ namespace Notion.Client
     public partial class CommentsClient
     {
         [SuppressMessage("ReSharper", "UnusedMember.Global")]
-        public async Task<RetrieveCommentsResponse> RetrieveAsync(RetrieveCommentsParameters parameters, CancellationToken cancellationToken = default)
+        public async Task<RetrieveCommentsResponse> RetrieveAsync(RetrieveCommentsRequest parameters, CancellationToken cancellationToken = default)
         {
             var qp = (IRetrieveCommentsQueryParameters)parameters;
 

Src/Notion.Client/Api/Comments/Retrieve/Request/RetrieveCommentsRequest.cs

@@ -0,0 +1,11 @@
+namespace Notion.Client
+{
+    public class RetrieveCommentsRequest : IRetrieveCommentsQueryParameters
+    {
+        public string BlockId { get; set; }
+
+        public string StartCursor { get; set; }
+
+        public int? PageSize { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/Create/DataSourcesClient.cs

@@ -0,0 +1,47 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public sealed partial class DataSourcesClient
+    {
+        public async Task<DataSource> CreateAsync(
+            CreateDataSourceRequest request,
+            CancellationToken cancellationToken = default)
+        {
+            var endpoint = ApiEndpoints.DataSourcesApiUrls.CreateDataSource();
+
+            if (request == null)
+            {
+                throw new ArgumentNullException(nameof(request));
+            }
+
+            ICreateDataSourceBodyParameters body = request;
+
+            if (body.Parent == null)
+            {
+                throw new ArgumentNullException(nameof(body.Parent), "Parent property cannot be null.");
+            }
+
+            if (body.Parent is DatabaseParentRequest dbParentRequest)
+            {
+                if (string.IsNullOrWhiteSpace(dbParentRequest.DatabaseId))
+                {
+                    throw new ArgumentException("DatabaseId in Parent cannot be null or empty when Parent is of type DatabaseParentRequest.", nameof(request.Parent));
+                }
+            }
+
+            if (body.Properties == null)
+            {
+                throw new ArgumentException("Properties cannot be null or empty.", nameof(body.Properties));
+            }
+
+            return await _restClient.PostAsync<DataSource>(
+                endpoint,
+                body,
+                cancellationToken: cancellationToken
+            );
+        }
+    }
+}

Src/Notion.Client/Api/DataSources/Create/Request/CreateDataSourceRequest.cs

@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+
+namespace Notion.Client
+{
+    public class CreateDataSourceRequest : ICreateDataSourceBodyParameters
+    {
+        public IParentOfDataSourceRequest Parent { get; set; }
+        public IDictionary<string, DataSourcePropertyConfigRequest> Properties { get; set; }
+        public IEnumerable<RichTextBaseInput> Title { get; set; }
+        public IPageIconRequest Icon { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/Create/Request/ICreateDataSourceBodyParameters.cs

@@ -0,0 +1,20 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface ICreateDataSourceBodyParameters
+    {
+        [JsonProperty("parent")]
+        public IParentOfDataSourceRequest Parent { get; set; }
+
+        [JsonProperty("properties")]
+        public IDictionary<string, DataSourcePropertyConfigRequest> Properties { get; set; }
+
+        [JsonProperty("title")]
+        public IEnumerable<RichTextBaseInput> Title { get; set; }
+
+        [JsonProperty("icon")]
+        public IPageIconRequest Icon { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/DataSourcesClient.cs

@@ -0,0 +1,12 @@
+namespace Notion.Client
+{
+    public sealed partial class DataSourcesClient : IDataSourcesClient
+    {
+        private readonly IRestClient _restClient;
+
+        public DataSourcesClient(IRestClient restClient)
+        {
+            _restClient = restClient;
+        }
+    }
+}