Upload Documents

curl --request POST \
  --url https://api.nugen.in/api/v3/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'categories=<string>' \
  --form files.items='@example-file'

{
  "document_ids": [
    "<string>"
  ]
}

Documents

Upload Documents

Upload multiple documents.

Request Body (multipart/form-data):

files: List of files to upload (required)
categories (optional): List of category names to organize documents

Returns:

list[str] containing:

List of unique IDs (strings) for tracking upload and processing status
One ID is returned for each uploaded file
Use these IDs to monitor processing progress

Supported File Types:

Text-based files only

File Size Limit:

Maximum 100 MB per file

Example Request:

POST /api/v3/documents
Headers: {"Authorization": "Bearer <api_key>"}
Content-Type: multipart/form-data

Form Data:
  files: [report.txt, analysis.md]
  categories: ["financial", "2024-q1"]

Example Response:

[
  "01KKBB7NPTMXM12",
  "01KKBB7NPTJDK43"
]

POST

api

documents

Upload Documents

curl --request POST \
  --url https://api.nugen.in/api/v3/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'categories=<string>' \
  --form files.items='@example-file'

{
  "document_ids": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

files

file[]

required

The document files to upload

Response

Returns a list of task IDs for the uploaded documents. This endpoint handles the upload of multiple documents, creates id for each document, and returns their unique task identifiers for tracking the upload and processing status.

document_ids

string[]

required

List of task identifiers for the uploaded documents. Use these IDs with the upload status endpoint to track processing progress and retrieve the final document IDs.

List Documents Upload Documents Status