Add a guide source

POST/epg/sources/

write Change: creates or edits. Scopes

Adds an XMLTV address (url, http or https); name defaults to its host. It is imported on the next round. Countries are added with "Choose the guide countries". Panel operators only.

Body

namestring
urlstring (uri)
is_activeboolean
priorityinteger
When two sources carry the same channel, the higher priority one supplies its programmes.

Response

201 OK

idintegerrequiredread-only
kindstringrequiredread-only
namestring
countrystringrequiredread-only
urlstring (uri)
is_activeboolean
priorityinteger
When two sources carry the same channel, the higher priority one supplies its programmes.
statusstringrequiredread-only
last_checked_atstring (date-time)requiredread-onlycan be null
last_imported_atstring (date-time)requiredread-onlycan be null
last_errorstringrequiredread-only
channels_countintegerrequiredread-only
programmes_countintegerrequiredread-only
updated_atstring (date-time)requiredread-only

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/epg/sources/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Channel A",
  "url": "https://example.com/",
  "is_active": true
}'

Python

import os
import requests

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

JavaScript

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

Response 201

{
  "id": 1,
  "kind": {
    "0": "m",
    "1": "i",
    "2": "n",
    "3": "i",
    "4": "m",
    "5": "u",
    "6": "s"
  },
  "name": "Channel A",
  "country": "string",
  "url": "https://example.com/",
  "is_active": true,
  "priority": 1,
  "status": {
    "0": "i",
    "1": "d",
    "2": "l",
    "3": "e"
  },
  "last_checked_at": "2026-11-13T12:00:00Z",
  "last_imported_at": "2026-11-13T12:00:00Z",
  "last_error": "string",
  "channels_count": 0,
  "programmes_count": 0,
  "updated_at": "2026-11-13T12:00:00Z"
}

Add a guide source

Body#

Response#

201 OK

Errors#

Body

Response

Errors