API
Delete video
DELETE /v1/videos/{id}: cancel a job or delete a finished file.
DELETE
/v1/videos/{id}The action depends on the job status:
| Status | What happens |
|---|---|
queued | the job is cancelled and no money is charged |
in_progress | 409 video_cancel_unsupported: the provider cannot cancel a job it has already accepted |
completed | the file is deleted |
A deleted file cannot be restored.
Headers
| Header | Value |
|---|---|
Authorization | Bearer <key>. Required. x-api-key: <key> is accepted instead |
Path parameters
idstringrequiredThe job identifier, like video_….
Request example
curl -X DELETE https://api.morphogen.ru/v1/videos/video_7f3a91c2 \
-H "Authorization: Bearer $MORPHOGEN_API_KEY"Response example
{
"id": "video_7f3a91c2",
"object": "video.deleted",
"deleted": true
}Errors
401
invalid_api_keyThe key is not found, disabled or expired.404
video_not_foundThere is no such job, or it belongs to another organization.409
video_cancel_unsupportedThe job is already with the provider and cannot be cancelled. Wait for it to finish.Other codes: Errors.