# place.stream.media.deleteVideo

> Delete a place.stream.video record and, on request, the track records its source points at. The content blob and the upload stay, so the record can be published again from the same upload. The caller must be the record's owner or hold livestream.manage from them; the records are deleted with the owner's session.

- Kind: procedure
- Authority: media.stream.place
- Lexicon: 1
- Published by [stream.place](https://lexicon.garden/identity/did:plc:rbvrr34edl5ddpuwcubjiost), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.media.deleteVideo)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.media.deleteVideo/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.media.deleteVideo/analytics)

## Procedure (`place.stream.media.deleteVideo`)

Type: procedure · POST

### Input (application/json)

- `tracks` (boolean): Also delete the video's track records.
  - Constraints: default: false
- `uri` (string · at-uri, required)

### Output (application/json)

- `deleted` (array, required): Every record deleted, the video first.
  - `items` (string · at-uri)

### Errors

- `NotPermitted`: The caller is neither the owner nor a moderator with livestream.manage from them.
- `VideoNotFound`: No such video record.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Delete a place.stream.video record and, on request, the track records its source points at. The content blob and the upload stay, so the record can be published again from the same upload. The caller must be the record's owner or hold livestream.manage from them; the records are deleted with the owner's session.",
      "errors": [
        {
          "description": "The caller is neither the owner nor a moderator with livestream.manage from them.",
          "name": "NotPermitted"
        },
        {
          "description": "No such video record.",
          "name": "VideoNotFound"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "tracks": {
              "default": false,
              "description": "Also delete the video's track records.",
              "type": "boolean"
            },
            "uri": {
              "format": "at-uri",
              "type": "string"
            }
          },
          "required": [
            "uri"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "deleted": {
              "description": "Every record deleted, the video first.",
              "items": {
                "format": "at-uri",
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "deleted"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "id": "place.stream.media.deleteVideo",
  "lexicon": 1
}
```