videos

Re-run processing of a failed video

Only for status: failed (400 otherwise). Re-downloads if the source came from a URL and the file is gone. 402 if the user is above quota.

post/api/videos/{id}/retry

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/videos/{id}/retry
  • Auth: one of:
    • HTTP bearer
    • API key in cookie session
    • OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Path parameters

idstring uuid required
Example:6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90

Video id (UUID)

Response

Video (processing)

idstring uuid required
titlestring required
pathstring

Server-side file path (informational)

urlstring required

Source file, relative to the server, e.g. /files/uploads/<id>.mp4

thumbnail_urlstring nullable
thumbnail_pathstring nullable
size_bytesinteger required
duration_snumber nullable

Seconds, null until probed

widthinteger nullable
heightinteger nullable
status'processing' | 'ready' | 'failed' required
state'queued' | 'running' | 'ready' | 'failed' required

processing split by the job queue: queued (waiting behind other videos) or running; otherwise = status

queue_positioninteger nullable

1-based position in the processing queue while state is queued

eta_snumber nullable

Estimated seconds until ready (0.25 × (duration + durations of the videos ahead)); null when not processing

progress'downloading' | 'probing' | 'transcribing' | 'detecting' | 'demo' | 'null' nullable

Current step while processing; null when ready/failed. demo = demo copy waiting for the master

errorstring nullable

Why it failed

is_demo0 | 1 required

1 = the sample video seeded at signup (cannot be exported on the free plan)

created_atstring required
clips_countinteger required

Example response

{
  "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
}

Changes

No recorded changes to this operation across all 1 revision of this API.