Add an outside guide

POST/editor/epg/external/

write Change: creates or edits. Scopes

Adds an XMLTV guide by its address. It is checked first, in a background task: one that cannot be read is listed with the reason, one that passes is read in a minute or two. An account may add 10.

Body

urlstring (uri)required
namestringrequired

Response

202 OK

jobstring (uuid)required
The background task: follow it with GET /editor/jobs/{id}/ (/editor/api/v1/jobs/{id}/ with a token).
sourceobjectrequired
- idintegerrequired
- namestringrequired
- urlstringrequired
- statusstringrequired
  checking while it is first checked, error when it failed.
- last_imported_atstring (date-time)requiredcan be null
- last_errorstringrequired
- channelsintegerrequired
- programmesintegerrequired
- minebooleanrequired
  Added from the playlist editor.
messagestringrequired

Errors

400 Something sent is not valid. Each field that is wrong is named with what is wrong.
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 -X POST 'https://panel.example.com/editor/epg/external/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/",
  "name": "Channel A"
}'

Python

import os
import requests

response = requests.post(
    "https://panel.example.com/editor/epg/external/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
    json={
        "url": "https://example.com/",
        "name": "Channel A"
    },
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/editor/epg/external/', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "url": "https://example.com/",
    "name": "Channel A"
  }),
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 202

{
  "job": "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b",
  "source": {
    "id": 1,
    "name": "Channel A",
    "url": "https://example.com/",
    "status": "string",
    "last_imported_at": "2026-11-13T12:00:00Z",
    "last_error": "string",
    "channels": 1,
    "programmes": 1,
    "mine": true
  },
  "message": "string"
}

Add an outside guide

Body#

Response#

202 OK

Errors#

Body

Response

Errors