Upload a file
POST/v1/files
Upload a file for use with the Batch API. OpenAI-compatible: send multipart/form-data with a purpose of batch and a JSONL file whose lines are batch request objects. DVARA applies the workspace's configured PII action to the complete upload as one text blob before choosing a batch-capable provider. It does not run each JSONL line through the live model-call pipeline. The default upload limit is 100 MB and can be changed with DVARA_BATCH_MAX_FILE_SIZE. OpenAI and Azure OpenAI declare production batch support; the Mock provider supports the flow for local development and tests.
Request
Responses
- 200
- 400
- 401
- 403
- 413
- 502
Uploaded file
The configured PII action blocked the upload.
A key is required. Missing, invalid, revoked, or expired keys are refused.
The key is valid but does not carry batches:write (api_key_scope).
The upload exceeds the configured multipart file-size limit.
Every configured provider on the route (and every fallback) has failed.