List a playlist's automatic backups

GET/editor/api/v1/playlists/{pid}/auto-backups/

Called with a playlist editor API token. How

Private copies made twice a day when the playlist changed: kept a week, one a week kept a month. Latest first.

Path parameters

pidstring (uuid)required

Headers

X-Token-Passwordstring
The token's own password, when it was made with one.

Response

200 OK

idintegerrequired
created_atstring (date-time)required
weeklybooleanrequired
Kept 35 days; the others 7.
sizeintegerrequired
Bytes.
countsobjectrequired
What it holds, by section.

Errors

401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
404 Nothing with this id, or nothing the account can see.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl 'https://panel.example.com/editor/api/v1/playlists/1/auto-backups/' \
  -H "Authorization: Bearer $EDITOR_TOKEN"

Python

import os
import requests

response = requests.get(
    "https://panel.example.com/editor/api/v1/playlists/1/auto-backups/",
    headers={"Authorization": f"Bearer {os.environ['EDITOR_TOKEN']}"},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/editor/api/v1/playlists/1/auto-backups/', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.EDITOR_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

[
  {
    "id": 1,
    "created_at": "2026-11-13T12:00:00Z",
    "weekly": true,
    "size": 1,
    "counts": {
      "key": 1
    }
  }
]

List a playlist's automatic backups

Path parameters#

Headers#

Response#

200 OK

Errors#

Path parameters

Headers

Response

Errors