Skip to content

Publish a place.stream.video record for a finished upload, server-side. The caller supplies the record it would otherwise putRecord itself; the server overrides the fields it is authoritative about (source tracks and durationMs, taken from the processed upload) and, if the record carries no thumb, generates one from the video and attaches it. The record is written to the authenticated user's repo. The caller must own the upload, or hold livestream.manage from its owner; the record is written with the owner's session. Without a record, one is built from the upload's livestream(s) (title, tags, activity, connections) and the given title and description.

POST
/xrpc/place.stream.media.publishVideo
object
uploadId
required

The upload ID returned by place.stream.media.createUpload. Its processing must be complete (status ‘done’).

string
record

A place.stream.video record. The server overrides source and durationMs from the processed upload, and fills in thumb with a generated thumbnail when the supplied record has none.

livestreams

Livestream records the video came from, used to build the record when none is given; defaults to the upload’s own livestream for a finalized recording.

Array<string>
title

Title for a record built by the server; the first livestream’s title when empty.

string
<= 1000 characters
description

Description for a record built by the server.

string
<= 10000 characters

Success

object
uri
required

AT-URI of the created place.stream.video record.

string format: uri
cid
required

CID of the created place.stream.video record.

string format: cid

Bad Request

object
error
required
One of:
string
message
required
string