clips

Cancel a queued or running export

Queued: removed from the render queue. Running: the ffmpeg process is killed within ~2 s and the partial file deleted. Either way the export stays readable with status: canceled. 400 if already done/failed/canceled.

delete/api/exports/{id}

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/exports/{id}
  • 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

Export id returned by exportClip

Response

Canceled export

idstring uuid required
clip_idstring uuid required
user_idstring uuid
orientation'vertical' | 'horizontal' | 'square' | 'portrait45' required

vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

status'queued' | 'running' | 'done' | 'failed' | 'canceled' required
progressinteger required

Render progress in %

eta_snumber nullable

Estimated seconds left while queued/running: moving-average render ratio of the last 10 finished exports × (remaining clip seconds + clips ahead in the queue); null otherwise

started_atstring nullable
finished_atstring nullable
urlstring nullable

/files/exports/<id>.mp4 once done (relative to the server base URL)

output_pathstring nullable
errorstring nullable
created_atstring required

Example response

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

Changes

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