# place.stream.vod.draftVideo

> A draft VOD: pre-publication video metadata and processing state. Modeled as a permissioned-data-style record (CBOR-serialized, addressed by an ats:// URI) stored in statedb until the permissioned-data spec ships (bluesky-social/proposals PR #94, the 0016-permissioned-data proposal). Publishing promotes it to a public place.stream.video record.

- Kind: record
- Record key: tid
- Authority: vod.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.vod.draftVideo)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.vod.draftVideo/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.vod.draftVideo/analytics)

## Record (`place.stream.vod.draftVideo`)

Type: record · key tid

### Properties

- `activity` (union): The game or activity in the video.
  - One of: `place.stream.defs#activityGame`, `place.stream.defs#activityLabel`
- `connections` (array): Related records (e.g. the source livestream for a finalized VOD).
  - `items` (union)
    - One of: `place.stream.video#connection`
- `contentRights` (ref)
  - Reference: `place.stream.metadata.contentRights`
- `contentWarnings` (ref)
  - Reference: `place.stream.metadata.contentWarnings`
- `createdAt` (string · datetime, required)
- `description` (string): Description of the video.
  - Constraints: maxLength: 50000, maxGraphemes: 5000
- `descriptionFacets` (array): Annotations of text (mentions, URLs, etc).
  - `items` (ref)
    - Reference: `place.stream.richtext.videoFacet`
- `durationMs` (integer): Duration in milliseconds. Filled when status is 'ready'.
- `error` (string): Error message when status is 'error'.
- `source` (union): Source tracks. Filled by the server when processing completes (status 'ready').
  - One of: `place.stream.media.defs#sourceTracks`, `place.stream.media.defs#sourceClip`
- `status` (string, required): Processing state: 'processing' while the job runs, 'ready' when publishable, 'error' if processing failed.
  - Constraints: knownValues: processing | ready | error
- `tags` (array): Freeform tags (same rules as place.stream.video).
  - Constraints: maxLength: 10
  - `items` (string)
    - Constraints: maxLength: 640, maxGraphemes: 64
- `thumb` (blob): Thumbnail image. Generated by the server at publish time if absent.
  - Constraints: maxSize: 1000000, accept: image/*
- `title` (string, required): Title of the video. May be a placeholder while processing; the user edits before publishing.
  - Constraints: maxLength: 1400, maxGraphemes: 140

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A draft VOD: pre-publication video metadata and processing state. Modeled as a permissioned-data-style record (CBOR-serialized, addressed by an ats:// URI) stored in statedb until the permissioned-data spec ships (bluesky-social/proposals PR #94, the 0016-permissioned-data proposal). Publishing promotes it to a public place.stream.video record.",
      "key": "tid",
      "record": {
        "properties": {
          "activity": {
            "description": "The game or activity in the video.",
            "refs": [
              "place.stream.defs#activityGame",
              "place.stream.defs#activityLabel"
            ],
            "type": "union"
          },
          "connections": {
            "description": "Related records (e.g. the source livestream for a finalized VOD).",
            "items": {
              "refs": [
                "place.stream.video#connection"
              ],
              "type": "union"
            },
            "type": "array"
          },
          "contentRights": {
            "ref": "place.stream.metadata.contentRights",
            "type": "ref"
          },
          "contentWarnings": {
            "ref": "place.stream.metadata.contentWarnings",
            "type": "ref"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Description of the video.",
            "maxGraphemes": 5000,
            "maxLength": 50000,
            "type": "string"
          },
          "descriptionFacets": {
            "description": "Annotations of text (mentions, URLs, etc).",
            "items": {
              "ref": "place.stream.richtext.videoFacet",
              "type": "ref"
            },
            "type": "array"
          },
          "durationMs": {
            "description": "Duration in milliseconds. Filled when status is 'ready'.",
            "type": "integer"
          },
          "error": {
            "description": "Error message when status is 'error'.",
            "type": "string"
          },
          "source": {
            "description": "Source tracks. Filled by the server when processing completes (status 'ready').",
            "refs": [
              "place.stream.media.defs#sourceTracks",
              "place.stream.media.defs#sourceClip"
            ],
            "type": "union"
          },
          "status": {
            "description": "Processing state: 'processing' while the job runs, 'ready' when publishable, 'error' if processing failed.",
            "knownValues": [
              "processing",
              "ready",
              "error"
            ],
            "type": "string"
          },
          "tags": {
            "description": "Freeform tags (same rules as place.stream.video).",
            "items": {
              "maxGraphemes": 64,
              "maxLength": 640,
              "type": "string"
            },
            "maxLength": 10,
            "type": "array"
          },
          "thumb": {
            "accept": [
              "image/*"
            ],
            "description": "Thumbnail image. Generated by the server at publish time if absent.",
            "maxSize": 1000000,
            "type": "blob"
          },
          "title": {
            "description": "Title of the video. May be a placeholder while processing; the user edits before publishing.",
            "maxGraphemes": 140,
            "maxLength": 1400,
            "type": "string"
          }
        },
        "required": [
          "title",
          "status",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "place.stream.vod.draftVideo",
  "lexicon": 1
}
```