Sign in

v4

latestOpenAPI 3.1.02026-08-086635375.7 KB
Avatar Videos

Get an avatar video

Returns authoritative job state and a fresh one-hour recording URL when the canonical replay is ready. A read also reconciles late recordings.

get/v1/avatar-videos/{id}

Path parameters

idstring required

Response

Avatar video resource

idstring required
status'pending' | 'running' | 'finalizing' | 'completed' | 'failed' | 'cancelled' required
completionReason'script_completed' | 'max_duration_reached' | 'cancelled' | 'null' nullable
truncatedboolean required
durationSecondsnumber nullable
effectiveMaxDurationSecondsinteger required
sessionIdstring nullable

Underlying normal EngineSession ID. Use its recording deletion endpoint for deletion.

retryOfstring nullable
createdAtstring date-time required
startedAtstring date-time nullable
completedAtstring date-time nullable
metadataobject required

Example response

{
  "id": "avv_123"
}