# Delete video

> DELETE /api/videos/[id]

By default, performs a soft delete with a 30-day retention period.
Query parameters:
- permanent=true: Permanently delete the video and clean up R2 storage
- retentionDays=N: Override the default retention period (only for soft delete)

```json
{
  "/videos/{id}": {
    "delete": {
      "tags": [
        "Videos"
      ],
      "summary": "Delete video",
      "operationId": "deleteVideo",
      "description": "DELETE /api/videos/[id]\n\nBy default, performs a soft delete with a 30-day retention period.\nQuery parameters:\n- permanent=true: Permanently delete the video and clean up R2 storage\n- retentionDays=N: Override the default retention period (only for soft delete)",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "description": "Id ID",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
            "format": "uuid"
          }
        }
      ],
      "responses": {
        "200": {
          "description": "Success"
        },
        "401": {
          "description": "Unauthorized"
        },
        "404": {
          "description": "Not found"
        }
      }
    }
  }
}
```