place.stream.vod.updateDraft
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).
Details · procedure
| Kind | procedure |
|---|---|
| Authority | vod.stream.place |
| Indexed |
Showing version bafyreif3fdith4ernpyd3ougfav2q7cpsrskorih73st2imn4dgcb3sgtq. Show the latest
Procedure
procedure · POSTInput
application/jsondescription
stringmaxLength: 50000maxGraphemes: 5000
descriptionFacets
arraytags
arraymaxLength: 10
maxLength: 640maxGraphemes: 64
thumb
blobmaxSize: 1000000accept: image/*
title
stringmaxLength: 1400maxGraphemes: 140
The ats:// URI of the draft to update.
Output
application/jsonErrors
NotFound
No draft exists with the given URI for the authenticated user.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Rewrite a place.stream.video record in place: retitle, redescribe or retag it, or point it at a finished upload's tracks (publishing them if the upload has none yet: the repair for a record published without tracks, or the way to point a record at a re-finalized VOD). Fields left out are kept; an empty description or tag list clears it. The caller must be the record's owner or hold livestream.manage from them; the record is written with the owner's session.
-
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.
-
Create an empty draft VOD in the 'processing' state. The draft is the durable anchor for an upload: the client creates it first, then passes its URI to place.stream.media.createUpload so the upload's processing fills this draft. Lets the user start editing metadata while the upload runs, and supports re-upload (a failed upload leaves the draft intact; a new createUpload with the same draftUri re-points it).
-
Promote a ready draft VOD to a public place.stream.video record. The server carries over source and durationMs from the draft, backfills a generated thumbnail if the draft has none, writes the video record via putRecord, then deletes the draft.
-
place.stream.moderation.updateLivestream
procedureUpdate livestream metadata on behalf of a streamer. Requires 'livestream.manage' permission. Updates a place.stream.livestream record in the streamer's repository.