Video Playlists

Update a video playlist

PUT

https://peertube2.cpy.re/api/v1/video-playlists/{playlistId}

If the video playlist is set as public, the playlist must have a assigned channel.

curl -X PUT 'https://peertube2.cpy.re/api/v1/video-playlists/42' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --form-string 'displayName=string' \
  --form-string 'privacy=1' \
  --form-string 'description=string'

const form = new FormData();
form.append('displayName', 'string');
form.append('privacy', '1');
form.append('description', 'string');
const response = await fetch('https://peertube2.cpy.re/api/v1/video-playlists/42', {
  method: 'PUT',
  headers: {"Authorization":"Bearer YOUR_TOKEN"},
  body: form,
});
console.log(await response.text());

import requests
from contextlib import ExitStack

with ExitStack() as stack:
    files = [
        ('displayName', (None, 'string')),
        ('privacy', (None, '1')),
        ('description', (None, 'string')),
    ]
    response = requests.request('PUT', 'https://peertube2.cpy.re/api/v1/video-playlists/42', headers={"Authorization":"Bearer YOUR_TOKEN"}, files=files)
    print(response.text)

Request Body

{
  "displayName": "string",
  "thumbnailfile": "<binary>",
  "privacy": 1,
  "description": "string"
}

Body

multipart/form-data

multipart/form-dataobject

Encoding

thumbnailfileimage/jpeg

displayNamestring

Video playlist display name

thumbnailfilestring<binary>

Video playlist thumbnail file

privacyVideoPlaylistPrivacySet123

Video playlist privacy policy (see /video-playlists/privacies)

descriptionstring

Video playlist description

videoChannelIdid

Video channel in which the playlist will be published

Show child attributes

id>= 1

Example

Parameters

playlistIdid>= 1requiredpath

Playlist id

Response

204No Content

successful operation

Authorization

OAuth2oauth2

Authenticating via OAuth requires the following steps:

Have an activated account
Generate an access token for that account at /api/v1/users/token.
Make requests with the Authorization: Bearer <token> header
Profit, depending on the role assigned to the account

Note that the access token is valid for 1 day and is given along with a refresh token valid for 2 weeks.

Docs by Sourcey