> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voidai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Video

> Delete a video and its associated assets

```
DELETE /v1/videos/{id}
```

Permanently deletes a video and all its associated assets (video file, thumbnail, spritesheet).

<Warning>
  This action is irreversible. Once deleted, the video cannot be recovered.
</Warning>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the video to delete.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the deletion was successful.
</ResponseField>

<ResponseField name="message" type="string">
  A confirmation message.
</ResponseField>

## Examples

### Delete a Video

<CodeGroup>
  ```python Python theme={null}
  import requests

  video_id = "vid_abc123"

  response = requests.delete(
      f"https://api.voidai.app/v1/videos/{video_id}",
      headers={"Authorization": "Bearer sk-voidai-your_key_here"}
  )

  result = response.json()
  print(result["message"])
  ```

  ```typescript TypeScript theme={null}
  const videoId = 'vid_abc123';

  const response = await fetch(`https://api.voidai.app/v1/videos/${videoId}`, {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer sk-voidai-your_key_here'
    }
  });

  const result = await response.json();
  console.log(result.message);
  ```

  ```bash cURL theme={null}
  curl -X DELETE https://api.voidai.app/v1/videos/vid_abc123 \
    -H "Authorization: Bearer sk-voidai-your_key_here"
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "success": true,
  "message": "Video deleted successfully"
}
```

## Error Responses

### Video Not Found

```json theme={null}
{
  "error": {
    "message": "Video not found",
    "type": "api_error",
    "code": "NOT_FOUND"
  }
}
```

### Unauthorized

```json theme={null}
{
  "error": {
    "message": "You do not have permission to delete this video",
    "type": "api_error",
    "code": "FORBIDDEN"
  }
}
```