Skip to main content
GET
Get signed upload status

Usage Example

Poll this endpoint after notify_upload_complete until the upload has finished verification and the media is ready for generation.

Authorizations

X-API-Key
string
header
required

API key for authentication. Obtain from your team admin.

Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

Query Parameters

media_id
string<uuid>
required

Media ID returned by upload_media

gcs_path
string

Optional storage path returned by upload_media; helps recover the canonical media if deduplication occurred

Response

Upload status returned successfully

media_id
string<uuid>

Original media ID provided by the client

canonical_media_id
string<uuid>

Canonical media ID to use for generation

upload_status
string

Current verification status for the uploaded media

duration_seconds
number | null

Video duration in seconds when available

frame_rate
number | null

Video frame rate (fps) when available