Upload file
POST /files
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
The file to upload
Team ID for file ownership
JSON string for additional metadata
Responses
Section titled “ Responses ”File uploaded successfully
object
Unique identifier for the file
ID of the team that owns this file
File name or relative path (e.g., ‘file.txt’ or ‘docs/file.txt’). Slashes preserved for directory structure.
Size of the file in bytes
MIME type of the file (e.g., text/csv, application/json)
SHA-256 hash of the file contents for deduplication
User ID of who uploaded this file, or null for system uploads
Source URL if file was ingested from a URL, or null for direct uploads
Custom key-value metadata attached to the file
object
Latest processing status for the file, or null if never processed
object
Type of the latest processing event (JOB_CREATED, JOB_STARTED, JOB_FAILED, JOB_SUCCEEDED)
When this processing event occurred
Version of the processor that handled this file
Additional event-specific data
When the file was uploaded
When the file was last modified
ID of the processing job created for this file, or null if job creation failed
Bad Request - Validation error or invalid input
object
Unauthorized - Authentication required or invalid token
object
Forbidden - Insufficient permissions
object
Not Found - Resource does not exist
object
Internal Server Error - Unexpected server error