Update Video Metadata

curl -X PATCH https://vision-agent.api.reka.ai/v2/videos/video_id \
     -H "X-Api-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "video_id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://s3.amazonaws.com/bucket/video.mp4?presigned=...",
  "status": "uploaded",
  "metadata": {
    "width": 1920,
    "height": 1080,
    "avg_fps": 23.976023976023978,
    "video_name": "Kathy test",
    "title": "Kathy test",
    "video_start_timestamp_utc_ms": 1,
    "duration": 641.939,
    "thumbnail": "https://demo-videos-bucket-reka.s3.eu-west-2.amazonaws.com/None/images/{image_id}",
    "description": "Uploaded video file: home/kathy/vids/tuscany.mp4",
    "source": "home/kathy/vids/tuscany.mp4"
  },
  "features": {
    "embeddings": "processing",
    "transcript": "ready"
  },
  "group_id": "string",
  "error": "string"
}

Update a video’s metadata (title/description).

Authentication

X-Api-Keystring

API key authentication via X-Api-Key header

AuthorizationBearer

Bearer token authentication via Authorization header

Path parameters

video_idstringRequired

Request

This endpoint expects an object.

titlestring or nullOptional

Updated title for the video. Pass null to leave the current title unchanged.

descriptionstring or nullOptional

Updated description for the video. Pass null to leave the current description unchanged.

Response

Successful Response

video_idstring

Unique identifier for the video

urlstring or null

Presigned S3 URL to access the video

statusenum or null

Upload status of the video

Allowed values:

metadataobject or null

Metadata for a video

featuresmap from strings to enums or null

Per-feature indexing statuses from the video_features table

group_idstring or null

Group ID if video belongs to a group

errorstring or null

Error message if upload/download failed