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

.codegen.json

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

box_sdk_gen/managers/ai.py

@@ -426,6 +426,7 @@ def create_ai_extract_structured(
         metadata_template: Optional[CreateAiExtractStructuredMetadataTemplate] = None,
         fields: Optional[List[CreateAiExtractStructuredFields]] = None,
         include_confidence_score: Optional[bool] = None,
+        include_reference: Optional[bool] = None,
         ai_agent: Optional[AiExtractStructuredAgent] = None,
         extra_headers: Optional[Dict[str, Optional[str]]] = None
     ) -> AiExtractStructuredResponse:
@@ -453,6 +454,8 @@ def create_ai_extract_structured(
                 :type fields: Optional[List[CreateAiExtractStructuredFields]], optional
                 :param include_confidence_score: A flag to indicate whether confidence scores for every extracted field should be returned., defaults to None
                 :type include_confidence_score: Optional[bool], optional
+                :param include_reference: A flag to indicate whether references for every extracted field should be returned., defaults to None
+                :type include_reference: Optional[bool], optional
                 :param extra_headers: Extra headers that will be included in the HTTP request., defaults to None
                 :type extra_headers: Optional[Dict[str, Optional[str]]], optional
         """
@@ -463,6 +466,7 @@ def create_ai_extract_structured(
             'metadata_template': metadata_template,
             'fields': fields,
             'include_confidence_score': include_confidence_score,
+            'include_reference': include_reference,
             'ai_agent': ai_agent,
         }
         headers_map: Dict[str, str] = prepare_params({**extra_headers})

box_sdk_gen/managers/hub_items.py

@@ -69,6 +69,7 @@ def get_hub_items_v2025_r0(
         self,
         hub_id: str,
         *,
+        parent_id: Optional[str] = None,
         marker: Optional[str] = None,
         limit: Optional[int] = None,
         box_version: BoxVersionHeaderV2025R0 = BoxVersionHeaderV2025R0._2025_0,
@@ -84,6 +85,12 @@ def get_hub_items_v2025_r0(
         for the URL `https://*.app.box.com/hubs/123`
         the `hub_id` is `123`.
                 :type hub_id: str
+                :param parent_id: 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., defaults to None
+                :type parent_id: Optional[str], optional
                 :param marker: Defines the position marker at which to begin returning results. This is
         used when paginating using marker-based pagination.
 
@@ -101,6 +108,7 @@ def get_hub_items_v2025_r0(
         query_params_map: Dict[str, str] = prepare_params(
             {
                 'hub_id': to_string(hub_id),
+                'parent_id': to_string(parent_id),
                 'marker': to_string(marker),
                 'limit': to_string(limit),
             }

box_sdk_gen/schemas/ai_extract_structured.py

@@ -115,6 +115,7 @@ def __init__(
         metadata_template: Optional[AiExtractStructuredMetadataTemplateField] = None,
         fields: Optional[List[AiExtractStructuredFieldsField]] = None,
         include_confidence_score: Optional[bool] = None,
+        include_reference: Optional[bool] = None,
         ai_agent: Optional[AiExtractStructuredAgent] = None,
         **kwargs
     ):
@@ -129,10 +130,13 @@ def __init__(
                 :type fields: Optional[List[AiExtractStructuredFieldsField]], optional
                 :param include_confidence_score: A flag to indicate whether confidence scores for every extracted field should be returned., defaults to None
                 :type include_confidence_score: Optional[bool], optional
+                :param include_reference: A flag to indicate whether references for every extracted field should be returned., defaults to None
+                :type include_reference: Optional[bool], optional
         """
         super().__init__(**kwargs)
         self.items = items
         self.metadata_template = metadata_template
         self.fields = fields
         self.include_confidence_score = include_confidence_score
+        self.include_reference = include_reference
         self.ai_agent = ai_agent

box_sdk_gen/schemas/ai_extract_structured_response.py

@@ -19,6 +19,7 @@ def __init__(
         *,
         completion_reason: Optional[str] = None,
         confidence_score: Optional[Dict] = None,
+        reference: Optional[Dict] = None,
         ai_agent_info: Optional[AiAgentInfo] = None,
         **kwargs
     ):
@@ -29,10 +30,13 @@ def __init__(
         :type completion_reason: Optional[str], optional
         :param confidence_score: 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., defaults to None
         :type confidence_score: Optional[Dict], optional
+        :param reference: The reference for each extracted field as a JSON dictionary. This can be empty if no field could be extracted., defaults to None
+        :type reference: Optional[Dict], optional
         """
         super().__init__(**kwargs)
         self.answer = answer
         self.created_at = created_at
         self.completion_reason = completion_reason
         self.confidence_score = confidence_score
+        self.reference = reference
         self.ai_agent_info = ai_agent_info

box_sdk_gen/schemas/v2025_r0/hub_item_operation_v2025_r0.py

@@ -1,5 +1,7 @@
 from enum import Enum
 
+from typing import Optional
+
 from box_sdk_gen.internal.base_object import BaseObject
 
 from box_sdk_gen.schemas.v2025_r0.file_reference_v2025_r0 import FileReferenceV2025R0
@@ -29,12 +31,17 @@ def __init__(
         self,
         action: HubItemOperationV2025R0ActionField,
         item: HubItemReferenceV2025R0,
+        *,
+        parent_id: Optional[str] = None,
         **kwargs
     ):
         """
         :param action: The action to perform on a Box Hub item.
         :type action: HubItemOperationV2025R0ActionField
+        :param parent_id: 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., defaults to None
+        :type parent_id: Optional[str], optional
         """
         super().__init__(**kwargs)
         self.action = action
         self.item = item
+        self.parent_id = parent_id

docs/ai.md

@@ -261,6 +261,8 @@ client.ai.create_ai_extract_structured(
   - The fields to be extracted from the provided items. For your request to work, you must provide either `metadata_template` or `fields`, but not both.
 - include_confidence_score `Optional[bool]`
   - A flag to indicate whether confidence scores for every extracted field should be returned.
+- include_reference `Optional[bool]`
+  - A flag to indicate whether references for every extracted field should be returned.
 - ai_agent `Optional[AiExtractStructuredAgent]`
 - extra_headers `Optional[Dict[str, Optional[str]]]`
   - Extra headers that will be included in the HTTP request.

docs/hub_items.md

@@ -22,6 +22,8 @@ client.hub_items.get_hub_items_v2025_r0(created_hub.id)
 
 - hub_id `str`
   - The unique identifier that represent a hub. The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`.
+- parent_id `Optional[str]`
+  - 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.
 - marker `Optional[str]`
   - Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires `usemarker` to be set to `true`.
 - limit `Optional[int]`