BoxAI Extract agent unavailable

[ipisces]

• [☑] I have checked that the SDK documentation doesn't solve my issue.
• [☑] I have checked that the API documentation doesn't solve my issue.
• [☑] I have searched the Box Developer Forums and my issue isn't already reported (or if it has been reported, I have attached a link to it, for reference).
• [☑] I have searched Issues in this repo and my issue isn't already reported.

Description of the Issue

I've been using the Box Java SDK to access the Box AI API ,and I've been consistently receiving a 400 Bad Request response since Jun 24th. I noticed that there is a change on Jun 24th, 2025 about Enhanced extract agent.
Has anyone encountered a similar issue or knows what might be causing this? Any insights would be greatly appreciated!

Steps to Reproduce

BoxAIResponse response = BoxAI.extractMetadataFreeform(
api,
"firstName, lastName, location, yearOfBirth, company",
Collections.singletonList(new BoxAIItem("123456", BoxAIItem.Type.FILE))
);

Error Message, Including Stack Trace

{
"type": "error",
"code": "bad_request",
"status": 400,
"message": "Bad request",
"help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
"request_id": "0585e7541e9348c28b2a5b367b4e3a16f"
}

Versions Used

Java SDK: 4.16.3
Java: 17.0.14

[congminh1254]

Hi @ipisces

Thanks for your question, I am contacting the team which responsible for this API for more information.

Bests,
Minh

[congminh1254]

Hi @ipisces

Can you provide a log recently so my teammate can take a look at request ID?

[ipisces]

Hi Minh,

Thanks so much for your prompt response and for reaching out to the team—really appreciate your help with this!

I’ve attached the recent logs that include the request details and IDs.


responce
{
"type": "error",
"code": "bad_request",
"status": 400,
"message": "Bad request",
"help_url": "https://developer.box.com/guides/api-calls/permissions-and-errors/common-errors/",
"request_id": "0585e7541e9348c28b2a5b367b4e3a16f"
}

Stack Trace
com.box.sdk.BoxAPIResponseException: The API returned an error code [400 | 07dd10549a4e3295f676d9444c4f8d69a.07dd10549a4e3295f676d9444c4f8d69a] bad_request - Bad request
at com.box.sdk.BoxAPIResponse.toBoxResponse(BoxAPIResponse.java:149) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxAPIRequest.trySend(BoxAPIRequest.java:610) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxAPIRequest.send(BoxAPIRequest.java:390) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxJSONRequest.send(BoxJSONRequest.java:106) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxJSONRequest.send(BoxJSONRequest.java:17) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxAPIRequest.send(BoxAPIRequest.java:357) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxJSONRequest.send(BoxJSONRequest.java:101) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxAI.extractMetadataFreeform(BoxAI.java:296) ~[box-java-sdk-4.16.3.jar:na]
at com.box.sdk.BoxAI.extractMetadataFreeform(BoxAI.java:263) ~[box-java-sdk-4.16.3.jar:na]

Looking forward to your team’s insights. Thanks again for looking into this!

Best regards,

[congminh1254]

I forwarded these logs to the team responsible for this endpoint, I will let you know when we have any update.

Thank you,
Minh

[congminh1254]

Hi @ipisces

I just got an answer for my question. As I can see, this is base on your enterprise configuration and your enterprise can only use the AI model from IBM. For the full list of AI models you can take a look here.

So for this AI extract request, you need to provide an custom AI Agent which specify the IBM Llama model ibm__llama_3_2_90b_vision_instruct, and then it should works.

Let me know if you need more help or any code example to make it works again.

Best regards,
Minh

[arjankowski]

Hi @ipisces, please let us know if the Minh's answer helped.

Regards,
Artur

[lukaszsocha2]

Hi @ipisces,
we believe that this issue was resolved. If the problem still occurs feel free to reopen this ticket or create a new one.
Best,
@lukaszsocha2