Add documents to a conversation

POST

Upload documents to a specified conversation.

There are some limitations when uploading files to a conversation:

Files can be up to 50 MB or 800 pages.
You can upload up to 100 MB per request.
You can have up to 100 documents per conversation.
There are specific supported file types

Path parameters

conversation_idstringRequired

The conversation ID.

You can list conversations and get their IDs with the List conversations endpoint.

Headers

IB-ContextstringOptional

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See Authorization and context identification for details.

Request

This endpoint expects a multipart form with multiple files.

filesfilesRequired

process_filesbooleanOptional

Flag to indicate whether the files should be processed after upload.

Response

Documents uploaded and processed successfully.

upload_statusobjectOptional

Summary of the upload status for uploaded files, divided into success and failure.

1	curl "${API_ROOT}/v2/conversations/<CONVERSATION-ID>/documents" \
2	-H "Authorization: Bearer ${API_TOKEN}" \
3	-H "IB-Context: ${IB_CONTEXT}"\
4	-F files="@/path/to/test.pdf" \
5	-F files="@/path/to/test2.pdf"

1	{
2	"upload_status": {
3	"success": [
4	{}
5	],
6	"failure": [
7	{}
8	]
9	}
10	}