feat: Add reference to AI and parent_id to HubsItems (box/box-openapi#588) (#1418)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "65f6eab", "specHash": "57b3004", "version": "10.7.0" }
+{ "engineHash": "65f6eab", "specHash": "ca63e5e", "version": "10.7.0" }

Box.Sdk.Gen.Net/Managers/HubItems/GetHubItemsV2025R0QueryParams.cs

@@ -18,6 +18,15 @@ public class GetHubItemsV2025R0QueryParams {
         /// </summary>
         public string HubId { get; }
 
+        /// <summary>
+        /// The unique identifier of an item list block within the Box Hub.
+        /// 
+        /// When provided, the response will only include items that belong
+        /// to the specified item list, allowing you to filter results to
+        /// items on a specific page or section.
+        /// </summary>
+        public string? ParentId { get; init; }
+
         /// <summary>
         /// Defines the position marker at which to begin returning results. This is
         /// used when paginating using marker-based pagination.

Box.Sdk.Gen.Net/Managers/HubItems/HubItemsManager.cs

@@ -28,7 +28,7 @@ public HubItemsManager(NetworkSession? networkSession = default) {
         /// </param>
         public async System.Threading.Tasks.Task<HubItemsV2025R0> GetHubItemsV2025R0Async(GetHubItemsV2025R0QueryParams queryParams, GetHubItemsV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
             headers = headers ?? new GetHubItemsV2025R0Headers();
-            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string?>() { { "hub_id", StringUtils.ToStringRepresentation(queryParams.HubId) }, { "marker", StringUtils.ToStringRepresentation(queryParams.Marker) }, { "limit", StringUtils.ToStringRepresentation(queryParams.Limit) } });
+            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string?>() { { "hub_id", StringUtils.ToStringRepresentation(queryParams.HubId) }, { "parent_id", StringUtils.ToStringRepresentation(queryParams.ParentId) }, { "marker", StringUtils.ToStringRepresentation(queryParams.Marker) }, { "limit", StringUtils.ToStringRepresentation(queryParams.Limit) } });
             Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
             FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_items"), method: "GET", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Parameters = queryParamsMap, Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
             return SimpleJsonSerializer.Deserialize<HubItemsV2025R0>(NullableUtils.Unwrap(response.Data));

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

@@ -34,6 +34,12 @@ public class AiExtractStructured : ISerializable {
         [JsonPropertyName("include_confidence_score")]
         public bool? IncludeConfidenceScore { get; init; }
 
+        /// <summary>
+        /// A flag to indicate whether references for every extracted field should be returned.
+        /// </summary>
+        [JsonPropertyName("include_reference")]
+        public bool? IncludeReference { get; init; }
+
         [JsonPropertyName("ai_agent")]
         public AiExtractStructuredAgent? AiAgent { get; init; }
 

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

@@ -30,6 +30,13 @@ public class AiExtractStructuredResponse : ISerializable {
         [JsonConverter(typeof(DictionaryObjectValuesConverter))]
         public Dictionary<string, object>? ConfidenceScore { get; init; }
 
+        /// <summary>
+        /// The reference for each extracted field as a JSON dictionary. This can be empty if no field could be extracted.
+        /// </summary>
+        [JsonPropertyName("reference")]
+        [JsonConverter(typeof(DictionaryObjectValuesConverter))]
+        public Dictionary<string, object>? Reference { get; init; }
+
         [JsonPropertyName("ai_agent_info")]
         public AiAgentInfo? AiAgentInfo { get; init; }
 

Box.Sdk.Gen.Net/Schemas/V2025R0/HubItemOperationV2025R0/HubItemOperationV2025R0.cs

@@ -16,6 +16,12 @@ public class HubItemOperationV2025R0 : ISerializable {
         [JsonPropertyName("item")]
         public HubItemReferenceV2025R0 Item { get; }
 
+        /// <summary>
+        /// The ID of the parent block to add the item to. Must be an Item List block. If not provided, the item will be added to the first page's first Item List block.
+        /// </summary>
+        [JsonPropertyName("parent_id")]
+        public string? ParentId { get; init; }
+
         public HubItemOperationV2025R0(HubItemOperationV2025R0ActionField action, HubItemReferenceV2025R0 item) {
             Action = action;
             Item = item;

Box.Sdk.Gen.NetFramework/Managers/HubItems/GetHubItemsV2025R0QueryParams.cs

@@ -18,6 +18,15 @@ public class GetHubItemsV2025R0QueryParams {
         /// </summary>
         public string HubId { get; set; }
 
+        /// <summary>
+        /// The unique identifier of an item list block within the Box Hub.
+        /// 
+        /// When provided, the response will only include items that belong
+        /// to the specified item list, allowing you to filter results to
+        /// items on a specific page or section.
+        /// </summary>
+        public string ParentId { get; set; }
+
         /// <summary>
         /// Defines the position marker at which to begin returning results. This is
         /// used when paginating using marker-based pagination.

Box.Sdk.Gen.NetFramework/Managers/HubItems/HubItemsManager.cs

@@ -28,7 +28,7 @@ public HubItemsManager(NetworkSession networkSession = default) {
         /// </param>
         public async System.Threading.Tasks.Task<HubItemsV2025R0> GetHubItemsV2025R0Async(GetHubItemsV2025R0QueryParams queryParams, GetHubItemsV2025R0Headers headers = default, System.Threading.CancellationToken cancellationToken = default) {
             headers = headers ?? new GetHubItemsV2025R0Headers();
-            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string>() { { "hub_id", StringUtils.ToStringRepresentation(queryParams.HubId) }, { "marker", StringUtils.ToStringRepresentation(queryParams.Marker) }, { "limit", StringUtils.ToStringRepresentation(queryParams.Limit) } });
+            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string>() { { "hub_id", StringUtils.ToStringRepresentation(queryParams.HubId) }, { "parent_id", StringUtils.ToStringRepresentation(queryParams.ParentId) }, { "marker", StringUtils.ToStringRepresentation(queryParams.Marker) }, { "limit", StringUtils.ToStringRepresentation(queryParams.Limit) } });
             Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
             FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_items"), method: "GET", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Parameters = queryParamsMap, Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
             return SimpleJsonSerializer.Deserialize<HubItemsV2025R0>(NullableUtils.Unwrap(response.Data));

Box.Sdk.Gen.NetFramework/Schemas/AiExtractStructured/AiExtractStructured.cs

@@ -34,6 +34,12 @@ public class AiExtractStructured : ISerializable {
         [JsonPropertyName("include_confidence_score")]
         public bool? IncludeConfidenceScore { get; set; }
 
+        /// <summary>
+        /// A flag to indicate whether references for every extracted field should be returned.
+        /// </summary>
+        [JsonPropertyName("include_reference")]
+        public bool? IncludeReference { get; set; }
+
         [JsonPropertyName("ai_agent")]
         public AiExtractStructuredAgent AiAgent { get; set; }
 

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

@@ -30,6 +30,13 @@ public class AiExtractStructuredResponse : ISerializable {
         [JsonConverter(typeof(DictionaryObjectValuesConverter))]
         public Dictionary<string, object> ConfidenceScore { get; set; }
 
+        /// <summary>
+        /// The reference for each extracted field as a JSON dictionary. This can be empty if no field could be extracted.
+        /// </summary>
+        [JsonPropertyName("reference")]
+        [JsonConverter(typeof(DictionaryObjectValuesConverter))]
+        public Dictionary<string, object> Reference { get; set; }
+
         [JsonPropertyName("ai_agent_info")]
         public AiAgentInfo AiAgentInfo { get; set; }