uploadDocument
POST/api/v1/upload
Uploads one or more files to the key's external/ folder (/data/user_data/external
for the agent) and processes them in the background (text extraction, OCR, search
index). Always answers 202 with a request_id; follow it with
GET /api/v2/files/uploads/{request_id} (Agent API), which reports each file's
status and, once stored, its file_id. A name already used in the folder gets a
UTC date suffix and the renamed_due_to_duplicate warning.
Request
Responses
- 202
- 400
- 401
- 403
- 409
- 415
Upload accepted; processing continues in the background.
No file, an unsupported or empty file, or a file over the limit.
Invalid or missing API key
Read-only key, or an organization without active billing.
The account's encrypted storage is locked (reason_code vault_locked).
The request is not multipart/form-data.