Skip to content

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.

POST
/xrpc/place.stream.media.updateVideo
curl --request POST \
--url https://example.com/xrpc/place.stream.media.updateVideo \
--header 'Content-Type: application/json' \
--data '{ "uri": "https://example.com", "title": "example", "description": "example", "tags": [ "example" ], "uploadId": "example" }'
Media typeapplication/json
object
uri
required

The place.stream.video record.

string format: uri
title
string
<= 1000 characters
description
string
<= 10000 characters
tags
Array<string>
uploadId

A finished upload whose tracks become the record’s source and whose duration the record’s.

string

Example generated

{
"uri": "https://example.com",
"title": "example",
"description": "example",
"tags": [
"example"
],
"uploadId": "example"
}

Success

Media typeapplication/json
object
uri
required
string format: uri
cid
required
string format: cid

Example generated

{
"uri": "https://example.com",
"cid": "example"
}

Bad Request

Media typeapplication/json
object
error
required
One of:
string
Allowed value: NotPermitted
message
required
string

Example

{
"error": "NotPermitted"
}