---
title: "Delete a video object"
method: DELETE
path: "/videos/{videoId}"
tags: ["Videos"]
---

# Delete a video object

`DELETE /videos/{videoId}`

Delete a video object by video ID. 

By default, deleted videos cannot be recovered. If you have the Video Restore feature enabled, this operation will discard the video instead of permanently deleting it. Make sure you subscribe to the Video Restore feature if you want to be able to restore deleted videos! 

The Video Restore feature retains videos for 90 days, after which the videos are permanently deleted.

## Path parameters

- `videoId` string, required

## Response `204`

No Content

## Other responses

- `404` — Not Found
- `429` — Too Many Requests

## Changes

> 50 revisions in range; 1 not diffed.

- **2024-04-16** `ec2b79bfdc8d` — 1 info
  - added the non-success response with the status `429`
- **2022-04-28** `f9532dd3578c` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2022-02-07** `2a4d90a64f88` — 6 warning, 3 info
  - the optional response header `X-RateLimit-Limit` removed for the status `204`
  - the optional response header `X-RateLimit-Limit` removed for the status `404`
  - the optional response header `X-RateLimit-Remaining` removed for the status `204`
  - the optional response header `X-RateLimit-Remaining` removed for the status `404`
  - …5 more

[Change history](https://skmtc.dev/apivideo/apis/api-video/changes/videos/:videoId/delete.md)

---

[API](https://skmtc.dev/apivideo/apis/api-video.md) · [All operations](https://skmtc.dev/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)