List streams worth tidying up

GET/streams/tidy/

read Read: looks, changes nothing. Scopes

Groups of streams worth a decision (not watched for days, failing for days, turned off for days, in no bouquet, or events whose date has passed), each with its count, a few names and the days it is about. Act on one with a bulk edit or delete whose filters hold tidy.

Response

200 OK

groupsobject[]required
- keystringrequired
  - unwatched - unwatched
  - failing - failing
  - disabled - disabled
  - unlisted - unlisted
  - ended - ended
  One of: "unwatched" "failing" "disabled" "unlisted" "ended"
- countintegerrequired
- daysintegerrequiredcan be null
- sampleobject[]required

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.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl 'https://panel.example.com/streams/tidy/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

response = requests.get(
    "https://panel.example.com/streams/tidy/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/streams/tidy/', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

{
  "groups": [
    {
      "key": "unwatched",
      "count": 0,
      "days": 1,
      "sample": [
        {
          "key": "string"
        }
      ]
    }
  ]
}

List streams worth tidying up

Response#

200 OK

Errors#

Response

Errors