watsonx Orchestrate

 View Only

 Questions about using the Orchestrate API with files

Benjamin Tranter's profile image
Benjamin Tranter posted Mon September 22, 2025 02:12 PM

From this link, at the bottom of the page under request body-->Example & Schema, when looking at the schema and the example input, there is a property named : "document_ids"
If I provide a document ID, where is the document located that is being referenced?

Another question: Is there any way to send a pdf via HTTP to an Agent using the Orchestrate API?

Laurent de Clermont-Tonnerre's profile image
Laurent de Clermont-Tonnerre posted Tue October 14, 2025 04:33 PM

Hello, For working with documents today, Orchestrate provides dedicated APIs:

  • v1/orchestrate/knowledge-bases/documents – to upload documents into knowledge bases that agents can use.
  • v1/orchestrate/agents/{agent_id}/threads/{thread_id}/chat-with-docs – to upload documents tied to a specific session/thread.


So if you want to send a PDF or other file to an agent, the supported way is via those document APIs, not through document_ids on /runs.

And in addition to that, note there are other features in the product today that handles files/PDFs, for example we can have python tools that take files as input; also there's the doc processing feature in flows.

I hope this helps 

Related Content