Skip to main content
DELETE

Overview

Deletes one rendered video.
This cannot be undone. The video, its file and its thumbnail are deleted. Download the file first if you want to keep it.
What happens:
  • The video is deleted. Get Video Details answers 404 for it from then on.
  • Its project stays. Get Project then shows the project’s previous render, or video: null if there is none; render it again with Render Project.
  • Posts already recorded for the video are deleted from Hooked. A video already published stays on the platform.
  • The storage the file used is given back to your team.
To delete the project as well, use Delete Project, which deletes all its videos.

When it is refused

Nothing is deleted and the answer is 409 while:

Errors

Authorizations

x-api-key
string
header
required

Path Parameters

videoId
string
required

The video ID: data.video.id from GET /v1/project/{projectId}, an item of GET /v1/video/list, data.videoId from POST /v1/render, or data.videoId in a webhook payload.

Response

Video deleted

success
boolean
message
string
data
object