feat: add signer language, cancel sign request reason (box/box-openapi#584)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "bfb97cc", "specHash": "ccdb456", "version": "10.5.0" }
+{ "engineHash": "bfb97cc", "specHash": "77eac4b", "version": "10.5.0" }

Box.Sdk.Gen.Net/Managers/Folders/GetFolderByIdQueryParams.cs

@@ -67,9 +67,10 @@ public class GetFolderByIdQueryParams {
         /// <summary>
         /// The offset of the item at which to begin the response.
         /// 
-        /// Queries with offset parameter value
-        /// exceeding 10000 will be rejected
-        /// with a 400 response.
+        /// Offset-based pagination is not guaranteed to work reliably for high offset values and may fail for large datasets. In
+        /// those cases, reduce the number of items in the folder (for example, by
+        /// restructuring the folder into smaller subfolders) before retrying the
+        /// request.
         /// </summary>
         public long? Offset { get; init; }
 

Box.Sdk.Gen.Net/Managers/Folders/GetFolderItemsQueryParams.cs

@@ -48,9 +48,8 @@ public class GetFolderItemsQueryParams {
         /// <summary>
         /// The offset of the item at which to begin the response.
         /// 
-        /// Queries with offset parameter value
-        /// exceeding 10000 will be rejected
-        /// with a 400 response.
+        /// Offset-based pagination is not guaranteed to work reliably for high offset values and may fail for large datasets. In
+        /// those cases, use marker-based pagination by setting `usemarker` to `true`.
         /// </summary>
         public long? Offset { get; init; }
 

Box.Sdk.Gen.Net/Managers/SignRequests/ISignRequestsManager.cs

@@ -14,13 +14,16 @@ public interface ISignRequestsManager {
     /// The ID of the signature request.
     /// Example: "33243242"
     /// </param>
+    /// <param name="requestBody">
+    /// Request body of cancelSignRequest method
+    /// </param>
     /// <param name="headers">
     /// Headers of cancelSignRequest method
     /// </param>
     /// <param name="cancellationToken">
     /// Token used for request cancellation.
     /// </param>
-    public System.Threading.Tasks.Task<SignRequest> CancelSignRequestAsync(string signRequestId, CancelSignRequestHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it.");
+    public System.Threading.Tasks.Task<SignRequest> CancelSignRequestAsync(string signRequestId, SignRequestCancelRequest? requestBody = null, CancelSignRequestHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it.");
 
         /// <summary>
     /// Resends a signature request email to all outstanding signers.

Box.Sdk.Gen.Net/Managers/SignRequests/SignRequestsManager.cs

@@ -21,16 +21,19 @@ public SignRequestsManager(NetworkSession? networkSession = default) {
         /// The ID of the signature request.
         /// Example: "33243242"
         /// </param>
+        /// <param name="requestBody">
+        /// Request body of cancelSignRequest method
+        /// </param>
         /// <param name="headers">
         /// Headers of cancelSignRequest method
         /// </param>
         /// <param name="cancellationToken">
         /// Token used for request cancellation.
         /// </param>
-        public async System.Threading.Tasks.Task<SignRequest> CancelSignRequestAsync(string signRequestId, CancelSignRequestHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+        public async System.Threading.Tasks.Task<SignRequest> CancelSignRequestAsync(string signRequestId, SignRequestCancelRequest? requestBody = null, CancelSignRequestHeaders? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
             headers = headers ?? new CancelSignRequestHeaders();
             Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() {  }, headers.ExtraHeaders));
-            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/sign_requests/", NullableUtils.Unwrap(StringUtils.ToStringRepresentation(signRequestId)), "/cancel"), method: "POST", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/sign_requests/", NullableUtils.Unwrap(StringUtils.ToStringRepresentation(signRequestId)), "/cancel"), method: "POST", contentType: "application/json", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Headers = headersMap, Data = requestBody != null ? SimpleJsonSerializer.Serialize(requestBody) : null, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
             return SimpleJsonSerializer.Deserialize<SignRequest>(NullableUtils.Unwrap(response.Data));
         }
 

Box.Sdk.Gen.Net/Schemas/AiExtractStructuredResponse/AiExtractStructuredResponse.cs

@@ -24,7 +24,7 @@ public class AiExtractStructuredResponse : ISerializable {
         public string? CompletionReason { get; init; }
 
         /// <summary>
-        /// The confidence score numeric values for each extracted field as a JSON dictionary. This can be empty if no field could be extracted.
+        /// The confidence score levels and numeric values for each extracted field as a JSON dictionary. This can be empty if no field could be extracted.
         /// </summary>
         [JsonPropertyName("confidence_score")]
         [JsonConverter(typeof(DictionaryObjectValuesConverter))]

Box.Sdk.Gen.Net/Schemas/SignRequestCancelRequest/SignRequestCancelRequest.cs

@@ -0,0 +1,35 @@
+using Box.Sdk.Gen;
+using System.Text.Json.Serialization;
+using System.Collections.Generic;
+using Box.Sdk.Gen.Internal;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class SignRequestCancelRequest : ISerializable {
+        /// <summary>
+        /// An optional reason for cancelling the sign request.
+        /// </summary>
+        [JsonPropertyName("reason")]
+        public string? Reason { get; init; }
+
+        public SignRequestCancelRequest() {
+            
+        }
+        internal string? RawJson { get; set; } = default;
+
+        void ISerializable.SetJson(string json) {
+            RawJson = json;
+        }
+
+        string? ISerializable.GetJson() {
+            return RawJson;
+        }
+
+        /// <summary>
+        /// Returns raw json response returned from the API.
+        /// </summary>
+        public Dictionary<string, object?>? GetRawData() {
+            return SimpleJsonSerializer.GetAllFields(this);
+        }
+
+    }
+}

Box.Sdk.Gen.Net/Schemas/SignRequestCreateSigner/SignRequestCreateSigner.cs

@@ -41,6 +41,10 @@ public class SignRequestCreateSigner : ISerializable {
         [JsonPropertyName("_issuppress_notificationsSet")]
         protected bool _isSuppressNotificationsSet { get; set; }
 
+        [JsonInclude]
+        [JsonPropertyName("_islanguageSet")]
+        protected bool _isLanguageSet { get; set; }
+
         protected string? _email { get; set; }
 
         protected string? _embedUrlExternalUserId { get; set; }
@@ -59,6 +63,8 @@ public class SignRequestCreateSigner : ISerializable {
 
         protected bool? _suppressNotifications { get; set; }
 
+        protected string? _language { get; set; }
+
         /// <summary>
         /// Email address of the signer.
         /// The email address of the signer is required when making signature requests, except when using templates that are configured to include emails.
@@ -158,6 +164,13 @@ public class SignRequestCreateSigner : ISerializable {
         [JsonPropertyName("suppress_notifications")]
         public bool? SuppressNotifications { get => _suppressNotifications; init { _suppressNotifications = value; _isSuppressNotificationsSet = true; } }
 
+        /// <summary>
+        /// The language of the user, formatted in modified version of the
+        /// [ISO 639-1](https://developer.box.com/guides/api-calls/language-codes) format.
+        /// </summary>
+        [JsonPropertyName("language")]
+        public string? Language { get => _language; init { _language = value; _isLanguageSet = true; } }
+
         public SignRequestCreateSigner() {
 
         }

Box.Sdk.Gen.NetFramework/Managers/Folders/GetFolderByIdQueryParams.cs

@@ -67,9 +67,10 @@ public class GetFolderByIdQueryParams {
         /// <summary>
         /// The offset of the item at which to begin the response.
         /// 
-        /// Queries with offset parameter value
-        /// exceeding 10000 will be rejected
-        /// with a 400 response.
+        /// Offset-based pagination is not guaranteed to work reliably for high offset values and may fail for large datasets. In
+        /// those cases, reduce the number of items in the folder (for example, by
+        /// restructuring the folder into smaller subfolders) before retrying the
+        /// request.
         /// </summary>
         public long? Offset { get; set; }
 

Box.Sdk.Gen.NetFramework/Managers/Folders/GetFolderItemsQueryParams.cs

@@ -48,9 +48,8 @@ public class GetFolderItemsQueryParams {
         /// <summary>
         /// The offset of the item at which to begin the response.
         /// 
-        /// Queries with offset parameter value
-        /// exceeding 10000 will be rejected
-        /// with a 400 response.
+        /// Offset-based pagination is not guaranteed to work reliably for high offset values and may fail for large datasets. In
+        /// those cases, use marker-based pagination by setting `usemarker` to `true`.
         /// </summary>
         public long? Offset { get; set; }