v25

latestOpenAPI 3.1.0raw.githubusercontent.com2025-11-204973358.2 KB

Files

Upload File Multipart

Upload a file directly in the request body. Use this for single file uploads from your application.

For video files, processing happens asynchronously - use GET /files/{file_uuid}/status to check processing status before accessing frames.

Args: file: The file to upload (multipart form data) workspace_uuid: Optional workspace to associate the file with

Returns: FileUploadResult with file_uuid for future reference and file_url for immediate access. For videos, check processing_status field - use status endpoint to poll until "completed".

post/v2/files/-/uploads

Query parameters

workspace_uuidstring nullable

Response

local_file_pathstring nullable

Local file path of the uploaded file, if available.

remote_uristring nullable

Remote URI to fetch the file from, if available.

content_typestring nullable

MIME type of the file (e.g., 'video/mp4'). If not provided, will be inferred from file extension.

file_uuidstring nullable

Unique identifier for the uploaded file.

file_urlstring nullable

URL to access the uploaded file, if available.

remote_file_pathstring nullable

Remote file path of the uploaded file, if available.

processing_statusstring

Processing status: pending, processing, completed, or failed.