Reka AI Documentation

Upload a video file or URL without triggering indexing.

X-Api-Keystring

API key authentication via X-Api-Key header

AuthorizationBearer

Bearer token authentication via Authorization header

This endpoint expects a multipart form containing an optional file.

filefileOptional

video_urlstringOptional

URL to download video from

video_namestringOptional

Display name for the video. Required for file uploads.

group_idstringOptional

ID of the video group to associate this video with

descriptionstringOptional

Video description

Successful Response

video_idstring

Unique identifier for the uploaded video

statusenum

Status of the upload

Allowed values:

metadataobject or null

Video metadata (populated after upload completes)

$	curl -X POST https://vision-agent.api.reka.ai/v2/videos \
>	-H "X-Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@<file1>

1	{
2	"video_id": "550e8400-e29b-41d4-a716-446655440000",
3	"status": "uploading",
4	"metadata": {
5	"width": 1920,
6	"height": 1080,
7	"avg_fps": 23.976023976023978,
8	"video_name": "Kathy test",
9	"title": "Kathy test",
10	"video_start_timestamp_utc_ms": 1,
11	"duration": 641.939,
12	"thumbnail": "https://demo-videos-bucket-reka.s3.eu-west-2.amazonaws.com/None/images/{image_id}",
13	"description": "Uploaded video file: home/kathy/vids/tuscany.mp4",
14	"source": "home/kathy/vids/tuscany.mp4"
15	}
16	}

$	curl -X POST https://vision-agent.api.reka.ai/v2/videos \
>	-H "X-Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F file=@<file1>

1	{
2	"video_id": "550e8400-e29b-41d4-a716-446655440000",
3	"status": "uploading",
4	"metadata": {
5	"width": 1920,
6	"height": 1080,
7	"avg_fps": 23.976023976023978,
8	"video_name": "Kathy test",
9	"title": "Kathy test",
10	"video_start_timestamp_utc_ms": 1,
11	"duration": 641.939,
12	"thumbnail": "https://demo-videos-bucket-reka.s3.eu-west-2.amazonaws.com/None/images/{image_id}",
13	"description": "Uploaded video file: home/kathy/vids/tuscany.mp4",
14	"source": "home/kathy/vids/tuscany.mp4"
15	}
16	}

Upload Video