POST/v1/agents/{agent_id}/knowledge

Upload a knowledge file

Uploads a knowledge file for a specific agent to ingest. Send the request as multipart/form-data with the document in the required file field; optionally provide a name or set overwrite.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
agent_idstringrequired
The unique identifier of the agent to add the knowledge file to.

Multipart form data for uploading a document to the agent's knowledge base.

filestringrequired
The document to ingest.
namestringoptional
An optional name for the uploaded document.
overwritebooleanoptional
Whether to overwrite an existing document.

1 status code
201Returns the ingested document object.

Error handling

The agent_id path parameter must identify an existing agent. The request body must include file and use multipart/form-data.