curl -X DELETE "https://api.hooked.so/v1/video/cm4x9n7q20003ab12xy98zt10" \
-H "x-api-key: your_api_key_here"
const videoId = "cm4x9n7q20003ab12xy98zt10";
const response = await fetch(`https://api.hooked.so/v1/video/${videoId}`, {
method: "DELETE",
headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const result = await response.json();
console.log(response.status, result.message);
import os
import requests
video_id = "cm4x9n7q20003ab12xy98zt10"
response = requests.delete(
f"https://api.hooked.so/v1/video/{video_id}",
headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
print(response.status_code, response.json()["message"])
{
"success": true,
"message": "Video deleted",
"data": {
"videoId": "cm4x9n7q20003ab12xy98zt10",
"deleted": true
}
}
{
"success": false,
"message": "Video is still rendering"
}
{
"success": false,
"message": "Video not found"
}
Videos
Delete Video
Delete a rendered video for good
DELETE
/
v1
/
video
/
{videoId}
curl -X DELETE "https://api.hooked.so/v1/video/cm4x9n7q20003ab12xy98zt10" \
-H "x-api-key: your_api_key_here"
const videoId = "cm4x9n7q20003ab12xy98zt10";
const response = await fetch(`https://api.hooked.so/v1/video/${videoId}`, {
method: "DELETE",
headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const result = await response.json();
console.log(response.status, result.message);
import os
import requests
video_id = "cm4x9n7q20003ab12xy98zt10"
response = requests.delete(
f"https://api.hooked.so/v1/video/{video_id}",
headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
print(response.status_code, response.json()["message"])
{
"success": true,
"message": "Video deleted",
"data": {
"videoId": "cm4x9n7q20003ab12xy98zt10",
"deleted": true
}
}
{
"success": false,
"message": "Video is still rendering"
}
{
"success": false,
"message": "Video not found"
}
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.
- The video is deleted. Get Video Details answers
404for it from then on. - Its project stays. Get Project then shows the project’s previous render, or
video: nullif 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.
When it is refused
Nothing is deleted and the answer is409 while:
message | What to do |
|---|---|
Video is still rendering | Wait until its status is COMPLETED or FAILED. |
Video has a pending scheduled post… | Cancel each post in data.scheduleIds with Cancel Scheduled Post, then delete again. |
curl -X DELETE "https://api.hooked.so/v1/video/cm4x9n7q20003ab12xy98zt10" \
-H "x-api-key: your_api_key_here"
const videoId = "cm4x9n7q20003ab12xy98zt10";
const response = await fetch(`https://api.hooked.so/v1/video/${videoId}`, {
method: "DELETE",
headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const result = await response.json();
console.log(response.status, result.message);
import os
import requests
video_id = "cm4x9n7q20003ab12xy98zt10"
response = requests.delete(
f"https://api.hooked.so/v1/video/{video_id}",
headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
)
print(response.status_code, response.json()["message"])
{
"success": true,
"message": "Video deleted",
"data": {
"videoId": "cm4x9n7q20003ab12xy98zt10",
"deleted": true
}
}
{
"success": false,
"message": "Video is still rendering"
}
{
"success": false,
"message": "Video not found"
}
Errors
| Status | When |
|---|---|
| 401 | Missing or invalid API key (code: "not_authenticated") |
| 403 | The team does not have the Hooked app product (code: "entitlement_required") |
| 404 | No such video, including one already deleted. Another team’s video, or an id that is not one, answers the same Video not found |
| 409 | The video is rendering, or it has a pending scheduled post. Nothing was deleted |
| 500 | Internal server error. Read the video before retrying: it may already be gone |
Authorizations
Path Parameters
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.