Skip to content

Update a draft VOD's editable metadata. Server-authoritative fields (source, durationMs, status) are preserved. Editing is allowed in any status, so the user can pre-fill metadata while processing. All fields except uri are optional (partial update).

POST
/xrpc/place.stream.vod.updateDraft
object
uri
required

The ats:// URI of the draft to update.

string
title
string
<= 1400 characters
description
string
<= 50000 characters
descriptionFacets
Array<object>

Annotation of a sub-string within rich text in a VOD description or comment.

object
index
required

Specifies the sub-string range a facet feature applies to. Start index is inclusive, end index is exclusive. Indices are zero-indexed, counting bytes of the UTF-8 encoded text. NOTE: some languages, like Javascript, use UTF-16 or Unicode codepoints for string slice indexing; in these languages, convert to byte arrays before working with facets.

object
byteStart
required
integer
byteEnd
required
integer
features
required
Array
One of:

Facet feature for mention of another account. The text is usually a handle, including a ’@’ prefix, but the facet reference is a DID.

object
did
required
string format: did
thumb
string format: binary
activity
One of:

A game from the gamesgamesgamesgames catalog, identified by its AT URI.

object
uri
required
string format: uri
name

Cached display name of the game.

string
tags
Array<string>
<= 10 items
contentWarnings

Content warnings for a stream.

object
warnings
Array<string>
contentRights

Content rights and attribution information.

object
creator

Name of the creator of the work.

string
copyrightNotice

Copyright notice for the work.

string
copyrightYear

Year of creation or publication.

integer
license

License URL or identifier.

string
creditLine

Credit line for the work.

string

Success

object
draft
required

A draft VOD with its ats:// URI and CID, for list/get responses.

object
uri
required

The ats:// URI of the draft record.

string
cid
required

CID (sha256 of CBOR record bytes, base32) of the draft record.

string
record
required

The place.stream.vod.draftVideo record body. Typed as unknown (matching commentView/livestreamView/videoView) because the @atproto/api client validator cannot validate a ref to a record-type lexicon.

Bad Request

object
error
required
One of:
string
message
required
string