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 (name/title/description) and optionally move group.

Authentication

X-Api-Keystring

API key authentication via X-Api-Key header

AuthorizationBearer

Bearer token authentication via Authorization header

Path parameters

video_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestring or nullOptional

Updated display name for the video. This is the name shown in listings and search results. Pass null to leave unchanged.

titlestring or nullOptional

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

descriptionstring or nullOptional

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

group_idstring or nullOptional

Move the video to this group. Pass null to leave unchanged. The group must exist and belong to the authenticated user.

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