Videos

Delete video

Permanently delete a finished video job and its video

DEL/v1/videos/{video_id}

Permanently deletes a finished job (completed, failed or cancelled) and its video. Without a delete, a completed video is kept for 7 days after it finishes and then removed automatically.

After deletion, the job returns 404 and no longer appears in List videos. Its Idempotency-Key cannot be reused: a create with that key returns 409 with code: "idempotency_key_reused". Deleting a job does not refund it.

Authorizations

Authorizationstringrequired

Your authentication credentials. For Basic authentication, populate Basic $INWORLD_API_KEY.

Path Parameters

video_idstringrequired

The id of a video job your workspace created (video_ followed by 32 hexadecimal characters).

Response

200 - application/json

idstring

objectenum<string>

Available options:video.deleted

deletedenum<boolean>

Available options:true

Delete video

curl -X DELETE 'https://api.inworld.ai/v1/videos/video_8f14e45fceea167a5a36dedd4bea2543' \
  -H "Authorization: Basic $INWORLD_API_KEY"

default_response

{
  "id": "video_8f14e45fceea167a5a36dedd4bea2543",
  "object": "video.deleted",
  "deleted": true
}