From 707ac115bff1f1d891eed3cd4d9170663ccf2a35 Mon Sep 17 00:00:00 2001 From: box-sdk-build Date: Thu, 19 Mar 2026 04:50:26 -0700 Subject: [PATCH 1/2] fix: feat: Add Hub Document API (part 2) (box/box-openapi#588) --- .codegen.json | 2 +- .../GetHubItemsV2025R0QueryParams.java | 20 ++++ .../managers/hubitems/HubItemsManager.java | 1 + .../AiExtractStructured.java | 24 ++++- .../AiExtractStructuredResponse.java | 26 ++++- .../HubItemOperationV2025R0.java | 100 +++++++++++++++++- 6 files changed, 168 insertions(+), 5 deletions(-) diff --git a/.codegen.json b/.codegen.json index 18a3bb140..536372853 100644 --- a/.codegen.json +++ b/.codegen.json @@ -1 +1 @@ -{ "engineHash": "65f6eab", "specHash": "57b3004", "version": "10.6.0" } +{ "engineHash": "65f6eab", "specHash": "ca63e5e", "version": "10.6.0" } diff --git a/src/main/java/com/box/sdkgen/managers/hubitems/GetHubItemsV2025R0QueryParams.java b/src/main/java/com/box/sdkgen/managers/hubitems/GetHubItemsV2025R0QueryParams.java index f7c75273a..4a936a588 100644 --- a/src/main/java/com/box/sdkgen/managers/hubitems/GetHubItemsV2025R0QueryParams.java +++ b/src/main/java/com/box/sdkgen/managers/hubitems/GetHubItemsV2025R0QueryParams.java @@ -11,6 +11,14 @@ public class GetHubItemsV2025R0QueryParams { */ public final String hubId; + /** + * 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. + */ + public String parentId; + /** * Defines the position marker at which to begin returning results. This is used when paginating * using marker-based pagination. @@ -28,6 +36,7 @@ public GetHubItemsV2025R0QueryParams(String hubId) { protected GetHubItemsV2025R0QueryParams(Builder builder) { this.hubId = builder.hubId; + this.parentId = builder.parentId; this.marker = builder.marker; this.limit = builder.limit; } @@ -36,6 +45,10 @@ public String getHubId() { return hubId; } + public String getParentId() { + return parentId; + } + public String getMarker() { return marker; } @@ -48,6 +61,8 @@ public static class Builder { protected final String hubId; + protected String parentId; + protected String marker; protected Long limit; @@ -56,6 +71,11 @@ public Builder(String hubId) { this.hubId = hubId; } + public Builder parentId(String parentId) { + this.parentId = parentId; + return this; + } + public Builder marker(String marker) { this.marker = marker; return this; diff --git a/src/main/java/com/box/sdkgen/managers/hubitems/HubItemsManager.java b/src/main/java/com/box/sdkgen/managers/hubitems/HubItemsManager.java index f89dddebe..8d1beb0f1 100644 --- a/src/main/java/com/box/sdkgen/managers/hubitems/HubItemsManager.java +++ b/src/main/java/com/box/sdkgen/managers/hubitems/HubItemsManager.java @@ -53,6 +53,7 @@ public HubItemsV2025R0 getHubItemsV2025R0( prepareParams( mapOf( entryOf("hub_id", convertToString(queryParams.getHubId())), + entryOf("parent_id", convertToString(queryParams.getParentId())), entryOf("marker", convertToString(queryParams.getMarker())), entryOf("limit", convertToString(queryParams.getLimit())))); Map headersMap = diff --git a/src/main/java/com/box/sdkgen/schemas/aiextractstructured/AiExtractStructured.java b/src/main/java/com/box/sdkgen/schemas/aiextractstructured/AiExtractStructured.java index 582201abe..551bd54f3 100644 --- a/src/main/java/com/box/sdkgen/schemas/aiextractstructured/AiExtractStructured.java +++ b/src/main/java/com/box/sdkgen/schemas/aiextractstructured/AiExtractStructured.java @@ -35,6 +35,10 @@ public class AiExtractStructured extends SerializableObject { @JsonProperty("include_confidence_score") protected Boolean includeConfidenceScore; + /** A flag to indicate whether references for every extracted field should be returned. */ + @JsonProperty("include_reference") + protected Boolean includeReference; + @JsonProperty("ai_agent") protected AiExtractStructuredAgent aiAgent; @@ -49,6 +53,7 @@ protected AiExtractStructured(Builder builder) { this.metadataTemplate = builder.metadataTemplate; this.fields = builder.fields; this.includeConfidenceScore = builder.includeConfidenceScore; + this.includeReference = builder.includeReference; this.aiAgent = builder.aiAgent; markNullableFieldsAsSet(builder.getExplicitlySetNullableFields()); } @@ -69,6 +74,10 @@ public Boolean getIncludeConfidenceScore() { return includeConfidenceScore; } + public Boolean getIncludeReference() { + return includeReference; + } + public AiExtractStructuredAgent getAiAgent() { return aiAgent; } @@ -86,12 +95,14 @@ public boolean equals(Object o) { && Objects.equals(metadataTemplate, casted.metadataTemplate) && Objects.equals(fields, casted.fields) && Objects.equals(includeConfidenceScore, casted.includeConfidenceScore) + && Objects.equals(includeReference, casted.includeReference) && Objects.equals(aiAgent, casted.aiAgent); } @Override public int hashCode() { - return Objects.hash(items, metadataTemplate, fields, includeConfidenceScore, aiAgent); + return Objects.hash( + items, metadataTemplate, fields, includeConfidenceScore, includeReference, aiAgent); } @Override @@ -113,6 +124,10 @@ public String toString() { + includeConfidenceScore + '\'' + ", " + + "includeReference='" + + includeReference + + '\'' + + ", " + "aiAgent='" + aiAgent + '\'' @@ -129,6 +144,8 @@ public static class Builder extends NullableFieldTracker { protected Boolean includeConfidenceScore; + protected Boolean includeReference; + protected AiExtractStructuredAgent aiAgent; public Builder(List items) { @@ -151,6 +168,11 @@ public Builder includeConfidenceScore(Boolean includeConfidenceScore) { return this; } + public Builder includeReference(Boolean includeReference) { + this.includeReference = includeReference; + return this; + } + public Builder aiAgent(AiAgentReference aiAgent) { this.aiAgent = new AiExtractStructuredAgent(aiAgent); return this; diff --git a/src/main/java/com/box/sdkgen/schemas/aiextractstructuredresponse/AiExtractStructuredResponse.java b/src/main/java/com/box/sdkgen/schemas/aiextractstructuredresponse/AiExtractStructuredResponse.java index b9e6dc286..c572a3f91 100644 --- a/src/main/java/com/box/sdkgen/schemas/aiextractstructuredresponse/AiExtractStructuredResponse.java +++ b/src/main/java/com/box/sdkgen/schemas/aiextractstructuredresponse/AiExtractStructuredResponse.java @@ -35,6 +35,12 @@ public class AiExtractStructuredResponse extends SerializableObject { @JsonProperty("confidence_score") protected Map confidenceScore; + /** + * The reference for each extracted field as a JSON dictionary. This can be empty if no field + * could be extracted. + */ + protected Map reference; + @JsonProperty("ai_agent_info") protected AiAgentInfo aiAgentInfo; @@ -52,6 +58,7 @@ protected AiExtractStructuredResponse(Builder builder) { this.createdAt = builder.createdAt; this.completionReason = builder.completionReason; this.confidenceScore = builder.confidenceScore; + this.reference = builder.reference; this.aiAgentInfo = builder.aiAgentInfo; markNullableFieldsAsSet(builder.getExplicitlySetNullableFields()); } @@ -72,6 +79,10 @@ public Map getConfidenceScore() { return confidenceScore; } + public Map getReference() { + return reference; + } + public AiAgentInfo getAiAgentInfo() { return aiAgentInfo; } @@ -89,12 +100,14 @@ public boolean equals(Object o) { && Objects.equals(createdAt, casted.createdAt) && Objects.equals(completionReason, casted.completionReason) && Objects.equals(confidenceScore, casted.confidenceScore) + && Objects.equals(reference, casted.reference) && Objects.equals(aiAgentInfo, casted.aiAgentInfo); } @Override public int hashCode() { - return Objects.hash(answer, createdAt, completionReason, confidenceScore, aiAgentInfo); + return Objects.hash( + answer, createdAt, completionReason, confidenceScore, reference, aiAgentInfo); } @Override @@ -116,6 +129,10 @@ public String toString() { + confidenceScore + '\'' + ", " + + "reference='" + + reference + + '\'' + + ", " + "aiAgentInfo='" + aiAgentInfo + '\'' @@ -132,6 +149,8 @@ public static class Builder extends NullableFieldTracker { protected Map confidenceScore; + protected Map reference; + protected AiAgentInfo aiAgentInfo; public Builder(Map answer, OffsetDateTime createdAt) { @@ -150,6 +169,11 @@ public Builder confidenceScore(Map confidenceScore) { return this; } + public Builder reference(Map reference) { + this.reference = reference; + return this; + } + public Builder aiAgentInfo(AiAgentInfo aiAgentInfo) { this.aiAgentInfo = aiAgentInfo; return this; diff --git a/src/main/java/com/box/sdkgen/schemas/v2025r0/hubitemoperationv2025r0/HubItemOperationV2025R0.java b/src/main/java/com/box/sdkgen/schemas/v2025r0/hubitemoperationv2025r0/HubItemOperationV2025R0.java index f5f1cd6bf..e3a0a5a58 100644 --- a/src/main/java/com/box/sdkgen/schemas/v2025r0/hubitemoperationv2025r0/HubItemOperationV2025R0.java +++ b/src/main/java/com/box/sdkgen/schemas/v2025r0/hubitemoperationv2025r0/HubItemOperationV2025R0.java @@ -1,5 +1,6 @@ package com.box.sdkgen.schemas.v2025r0.hubitemoperationv2025r0; +import com.box.sdkgen.internal.NullableFieldTracker; import com.box.sdkgen.internal.SerializableObject; import com.box.sdkgen.schemas.v2025r0.filereferencev2025r0.FileReferenceV2025R0; import com.box.sdkgen.schemas.v2025r0.folderreferencev2025r0.FolderReferenceV2025R0; @@ -26,6 +27,13 @@ public class HubItemOperationV2025R0 extends SerializableObject { protected final HubItemReferenceV2025R0 item; + /** + * 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. + */ + @JsonProperty("parent_id") + protected String parentId; + public HubItemOperationV2025R0( HubItemOperationV2025R0ActionField action, FileReferenceV2025R0 item) { super(); @@ -83,6 +91,14 @@ public HubItemOperationV2025R0( this.item = item; } + protected HubItemOperationV2025R0(Builder builder) { + super(); + this.action = builder.action; + this.item = builder.item; + this.parentId = builder.parentId; + markNullableFieldsAsSet(builder.getExplicitlySetNullableFields()); + } + public EnumWrapper getAction() { return action; } @@ -91,6 +107,10 @@ public HubItemReferenceV2025R0 getItem() { return item; } + public String getParentId() { + return parentId; + } + @Override public boolean equals(Object o) { if (this == o) { @@ -100,12 +120,14 @@ public boolean equals(Object o) { return false; } HubItemOperationV2025R0 casted = (HubItemOperationV2025R0) o; - return Objects.equals(action, casted.action) && Objects.equals(item, casted.item); + return Objects.equals(action, casted.action) + && Objects.equals(item, casted.item) + && Objects.equals(parentId, casted.parentId); } @Override public int hashCode() { - return Objects.hash(action, item); + return Objects.hash(action, item, parentId); } @Override @@ -118,6 +140,80 @@ public String toString() { + "item='" + item + '\'' + + ", " + + "parentId='" + + parentId + + '\'' + "}"; } + + public static class Builder extends NullableFieldTracker { + + protected final EnumWrapper action; + + protected final HubItemReferenceV2025R0 item; + + protected String parentId; + + public Builder(HubItemOperationV2025R0ActionField action, FileReferenceV2025R0 item) { + super(); + this.action = new EnumWrapper(action); + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder(HubItemOperationV2025R0ActionField action, FolderReferenceV2025R0 item) { + super(); + this.action = new EnumWrapper(action); + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder(HubItemOperationV2025R0ActionField action, WeblinkReferenceV2025R0 item) { + super(); + this.action = new EnumWrapper(action); + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder(HubItemOperationV2025R0ActionField action, HubItemReferenceV2025R0 item) { + super(); + this.action = new EnumWrapper(action); + this.item = item; + } + + public Builder( + EnumWrapper action, FileReferenceV2025R0 item) { + super(); + this.action = action; + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder( + EnumWrapper action, FolderReferenceV2025R0 item) { + super(); + this.action = action; + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder( + EnumWrapper action, WeblinkReferenceV2025R0 item) { + super(); + this.action = action; + this.item = new HubItemReferenceV2025R0(item); + } + + public Builder( + EnumWrapper action, HubItemReferenceV2025R0 item) { + super(); + this.action = action; + this.item = item; + } + + public Builder parentId(String parentId) { + this.parentId = parentId; + return this; + } + + public HubItemOperationV2025R0 build() { + return new HubItemOperationV2025R0(this); + } + } } From 93aa11470a11c18db20c1689c1964bff2c0aed4e Mon Sep 17 00:00:00 2001 From: box-sdk-build Date: Thu, 19 Mar 2026 05:49:53 -0700 Subject: [PATCH 2/2] chore: Update `.codegen.json` with commit hash of `codegen` and `openapi` spec [skip ci] --- .codegen.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.codegen.json b/.codegen.json index 536372853..aad43783a 100644 --- a/.codegen.json +++ b/.codegen.json @@ -1 +1 @@ -{ "engineHash": "65f6eab", "specHash": "ca63e5e", "version": "10.6.0" } +{ "engineHash": "7c01dda", "specHash": "ca63e5e", "version": "10.6.0" }