---
title: "Erase a video and everything derived from it"
method: DELETE
path: "/v1/videos/{videoId}"
tags: ["Video"]
---

# Erase a video and everything derived from it

`DELETE /v1/videos/{videoId}`

## Request

- Base URL: `https://api.tryplayhead.com`
- URL: `https://api.tryplayhead.com/v1/videos/{videoId}`
- Auth: HTTP bearer

Hard deletion: stored sheets, the transcript, the cached source file and every derived artifact. This is the GDPR erasure path, so it does not tombstone — after it returns, the data is gone and a later call about the same URL is a fresh, chargeable run.

## Path parameters

- `videoId` string, required

## Response `200`

What was removed.

- object
  - `video_id` string
  - `deleted` boolean

## Other responses

- `401`: Missing, malformed or expired credential.
- `404`: No such video.

---

[API](https://skmtc.dev/tryplayhead/apis/playhead-api.md) · [All operations](https://skmtc.dev/tryplayhead/apis/playhead-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryplayhead/apis/playhead-api/revisions/21dfb775b852?raw)