Upload a Document to a Corpus

Enables authorized users to upload a new document into a specific corpus by providing essential details via a multipart/form-data request.

Purpose:

Designed for adding new content to an existing corpus.

Ensures each document is properly linked with a corpus and can be processed asynchronously.
Note: For additional capabilities like indexing and tagging please utilize the same endpoint by adding a prefix of /indexing-service. (E.g. /indexing-service/api/v2/corpora/{corpus_id}/documents). Stay tuned for the detailed
documentation of the indexing-service

Request Body Parameters (form-data):

content_type (str, required): Specifies the type of content being uploaded. Must be one of: 'file', 'text', or 'weblink'.

source (str or file, required): The content itself — either a text string, a URL, or a file (e.g., PDF, DOCX, TXT).

upload_from (str, required): Indicates the origin of the upload (e.g., 'web').

user_id (int, required): ID of the user performing the upload.

Supported Upload Types:

File Upload

Uploads supported document files, including:
PDF, Word, Excel, CSV, PPTX, RTF, EML, EPUB, XML, KML, GZ, JSON, Text, HTML, ZIP, Open Document formats.

content_type: 'file'

source: File to upload (e.g., sample.pdf, report.docx, data.xlsx)

Text Upload

Uploads plain text input.

content_type: 'text'

source: Any text string (e.g., "I am learning...")

Weblink Upload

Uploads a URL pointing to an online webpage or document.

content_type: 'weblink'

source: Valid URL (e.g., https://example.com/doc.pdf)

Returns

A JSON Response containing the uploaded document data

Current Version:

2.0.0

curl --location -g --request POST 'https:///api/v2/corpora//documents' \ --header 'Ocp-Apim-Subscription-Key: ' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: multipart/form-data' \ --form 'user_id=""' \ --form 'source=""' \ --form 'content_type=""' \ --form 'upload_from=""'

Upload a Document to a Corpus

Request

Responses