Support notion version 2025-09-03

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -1,4 +1,6 @@
-namespace Notion.Client
+using System;
+
+namespace Notion.Client
 {
     public static class ApiEndpoints
     {
@@ -148,5 +150,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/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/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<CreateDataSourceResponse> 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<CreateDataSourceResponse>(
+                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, PropertyConfigurationRequest> 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, PropertyConfigurationRequest> Properties { get; set; }
+
+        [JsonProperty("title")]
+        public IEnumerable<RichTextBaseInput> Title { get; set; }
+
+        [JsonProperty("icon")]
+        public IPageIconRequest Icon { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/Create/Response/CreateDataSourceResponse.cs

@@ -0,0 +1,6 @@
+namespace Notion.Client
+{
+    public class CreateDataSourceResponse : DataSourceResponse
+    {
+    }
+}

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;
+        }
+    }
+}

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

@@ -0,0 +1,63 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public interface IDataSourcesClient
+    {
+        /// <summary>
+        /// Retrieves a data source by its ID.
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<RetrieveDataSourceResponse> RetrieveAsync(
+            RetrieveDataSourceRequest request,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Creates a new data source.
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<CreateDataSourceResponse> CreateAsync(
+            CreateDataSourceRequest request,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Updates an existing data source.
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<UpdateDataSourceResponse> UpdateAsync(
+            UpdateDataSourceRequest request,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Lists the templates for a data source.
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<ListDataSourceTemplatesResponse> ListDataSourceTemplatesAsync(
+            ListDataSourceTemplatesRequest request,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Queries a data source.
+        /// </summary>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<QueryDataSourceResponse> QueryAsync(
+            QueryDataSourceRequest request,
+            CancellationToken cancellationToken = default
+        );
+    }
+}

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

@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Notion.Client
+{
+    public sealed partial class DataSourcesClient
+    {
+        public async Task<ListDataSourceTemplatesResponse> ListDataSourceTemplatesAsync(
+            ListDataSourceTemplatesRequest request,
+            CancellationToken cancellationToken = default)
+        {
+            if (request == null)
+            {
+                throw new ArgumentNullException(nameof(request));
+            }
+
+            if (string.IsNullOrWhiteSpace(request.DataSourceId))
+            {
+                throw new ArgumentException("DataSourceId cannot be null or empty.", nameof(request.DataSourceId));
+            }
+
+            IListDataSourceTemplatesPathParameters pathParameters = request;
+
+            var endpoint = ApiEndpoints.DataSourcesApiUrls.ListDataSourceTemplates(pathParameters);
+
+            IListDataSourceTemplatesQueryParameters queryParameters = request;
+
+            var queryParams = new Dictionary<string, string>()
+            {
+                { "name", queryParameters.Name },
+                { "start_cursor", queryParameters.StartCursor },
+                { "page_size", queryParameters.PageSize?.ToString() }
+            };
+
+            return await _restClient.GetAsync<ListDataSourceTemplatesResponse>(
+                endpoint,
+                queryParams: queryParams,
+                cancellationToken: cancellationToken
+            );
+        }
+    }
+}

Src/Notion.Client/Api/DataSources/ListTemplates/Request/IListDataSourceTemplatesPathParameters.cs

@@ -0,0 +1,10 @@
+namespace Notion.Client
+{
+    public interface IListDataSourceTemplatesPathParameters
+    {
+        /// <summary>
+        /// The ID of the data source.
+        /// </summary>
+        public string DataSourceId { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/ListTemplates/Request/IListDataSourceTemplatesQueryParameters.cs

@@ -0,0 +1,13 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public interface IListDataSourceTemplatesQueryParameters : IPaginationParameters
+    {
+        /// <summary>
+        /// Filter templates by name (case-insensitive substring match).
+        /// </summary>
+        [JsonProperty("name")]
+        string Name { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/ListTemplates/Request/ListDataSourceTemplatesRequest.cs

@@ -0,0 +1,10 @@
+namespace Notion.Client
+{
+    public class ListDataSourceTemplatesRequest : IListDataSourceTemplatesPathParameters, IListDataSourceTemplatesQueryParameters
+    {
+        public string DataSourceId { get; set; }
+        public string Name { get; set; }
+        public string StartCursor { get; set; }
+        public int? PageSize { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/ListTemplates/Response/DataSourceTemplate.cs

@@ -0,0 +1,25 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class DataSourceTemplate
+    {
+        /// <summary>
+        /// The unique identifier of the data source template.
+        /// </summary>
+        [JsonProperty("id")]
+        public string Id { get; set; }
+
+        /// <summary>
+        /// The name of the data source template.
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Indicates whether the template is the default template for the data source.
+        /// </summary>
+        [JsonProperty("is_default")]
+        public bool IsDefault { get; set; }
+    }
+}

Src/Notion.Client/Api/DataSources/ListTemplates/Response/ListDataSourceTemplatesResponse.cs

@@ -0,0 +1,26 @@
+using System.Collections.Generic;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class ListDataSourceTemplatesResponse
+    {
+        /// <summary>
+        /// A collection of data source templates.
+        /// </summary>
+        [JsonProperty("templates")]
+        public IEnumerable<DataSourceTemplate> Templates { get; set; }
+
+        /// <summary>
+        /// Indicates whether there are more templates to retrieve.
+        /// </summary>
+        [JsonProperty("has_more")]
+        public bool HasMore { get; set; }
+
+        /// <summary>
+        /// The cursor to use for fetching the next page of templates.
+        /// </summary>
+        [JsonProperty("next_cursor")]
+        public string NextCursor { get; set; }
+    }
+}