Upload multiple files
POST /files/batch
Upload up to 10 files (max 200MB total) with optional per-file metadata
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
Files to upload (max 10 files, max 200MB total)
Team ID for file ownership
JSON string mapping filenames to metadata objects
Responses
Section titled “ Responses ”Batch upload completed (may include partial failures)
object
Successfully uploaded files
object
Unique identifier for the uploaded file
Sanitized filename
Upload status
ID of the processing job, or null if job creation failed
Files that failed to upload
object
Original filename that failed
Human-readable error message
Machine-readable error code
Bad Request - Validation error or invalid input
object
Unauthorized - Authentication required or invalid token
object
Payment Required - Cost limit exceeded or not configured
object
Forbidden - Insufficient permissions
object
Not Found - Resource does not exist
object
Internal Server Error - Unexpected server error