Delete submission
Permanently deletes a submission and all its generated clips. This action cannot be undone. A submission still processing is cancelled and its credits refunded.
Authorization
apiKey In: header
Path Parameters
Response Body
application/json
application/json
curl -X DELETE "https://example.com/clips/string/submissions/string"Get submission GET
Returns the current status of a clipping submission. Poll this endpoint until `status` is `completed` or `failed`. We recommend polling every **5–10 seconds**. When `status` is `queued`, use `queue_position` and `estimated_time` to give feedback to your users. A submission can sit at `downloading` because the SOURCE is not fully published yet — a scheduled premiere, a livestream still on air, or a recording the platform is still processing. In that case `waiting_reason` is set (and `waiting_until` carries the announced start time, when the platform provides one). This is not an error and the submission is not stuck: it resumes on its own once the source becomes available. Surface it to your users instead of a generic "downloading", and offer them the option to cancel — `DELETE /v1/clips/{videoId}/submissions/{submissionId}` refunds the credits while `waiting_reason` is set.
Retry a failed submission POST
Runs a `failed` submission again with the exact settings it was created with (strategy, timeframe, template, translation) and returns the NEW submission, charged like `POST /clips`. The failed one stays in the history. Retrying a submission that did not fail answers `409 SUBMISSION_NOT_FAILED`.