Skip to main content
POST
Upload files

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

multipart/form-data
files
file[]
required

File(s) to upload. Audio files limited to 25MB, non-audio limited to 150MB.

confidential
string

Legacy global confidential flag (string 'true'/'false'). Only applied when institution is provided. Overridden per-file by fileConfidential.

Example:

"false"

fileConfidential
string

JSON string mapping original filenames to per-file confidential booleans. Example: '{"report.pdf": true, "notes.txt": false}'. Overrides the global confidential flag.

Example:

"{\"report.pdf\": true, \"notes.txt\": false}"

skipIndexing
string

Global skip-indexing flag (string 'true'/'false'). When true, all files in this upload batch skip RAG embedding generation and are set to status 'active' with no embeddings. Overridden per-file by fileSkipIndexing.

Example:

"false"

fileSkipIndexing
string

JSON string mapping original filenames to per-file skip-indexing booleans. Example: '{"report.pdf": true, "notes.txt": false}'. Overrides the global skipIndexing flag.

Example:

"{\"report.pdf\": true}"

institution
string

Institution ID to associate the uploads with

Example:

"6631915765bb0a94cfd6ca99"

account_shared
string

When 'true' and institution is set, marks files as shared across the institution's account

Example:

"false"

selectedCourse
string

JSON string with course context for the upload history record. Example: '{"course_id": 1750532703472, "course_name": "Research"}'

Example:

"{\"course_id\": 1750532703472, \"course_name\": \"Research\"}"

selectedAssistant
string

Assistant ID for the upload history record (used as fallback if selectedCourse.assistant._id is not set)

Example:

"6856fa89cbafcff8d98680f5"

collection
string

Collection ID to associate the uploaded files with. When provided, each Upload record is linked to this collection.

Example:

"6631915765bb0a94cfd6ca99"

Response

Upload completed. Individual file results are in the files array; each file has its own success/message.

success
boolean
Example:

true

message
string
Example:

"Upload completed"

files
object[]

Array of per-file processing results