VisionAPI ReferenceVideo Management

Upload Video

Upload a new video for search and Q&A

Authentication

X-Api-Keystring
API Key authentication via header

Request

This endpoint expects a multipart form containing an optional file.
filefileOptional

Video file to upload (mutually exclusive with video_url)

video_urlstringOptionalformat: "uri"

URL of the video to upload (mutually exclusive with file)

video_namestringRequired
Name of the video
video_start_absolute_timestampstringOptionalformat: "date-time"
Absolute start timestamp of the video in ISO 8601 format
indexbooleanRequiredDefaults to true

Whether to index the video for search and Q&A

enable_thumbnailsbooleanOptionalDefaults to false

Whether to generate thumbnails for video chunks (increases indexing time but allows quick thumbnail loading at search time)

Response

OK
video_idstring
Unique identifier for the uploaded video
statusstring
Status of the upload
video_s3_urlstring or null

S3 URL of the uploaded video (null for background processing)

Errors