Skip to main content
All endpoints need an admin token.

Settings

PUT merges the fields you send into the current settings, so you only need to send what changes. It returns the merged result in the same {"settings": {...}} shape.
Pro/Lifetime settings (the remote transcoder and self-heal blocks) are kept as they were unless the server is linked to a Pro account. The save still succeeds.

Hot reload

POST /api/admin/server/reload New in 0.9.0 Re-executes the server binary in place without stopping Live TV streams. Sending SIGUSR2 to the process does the same thing.

Libraries

Refresh Live TV

Both run in the background and return {"status": "started"} right away.

Tasks

Long-running jobs run as tasks. POST /api/admin/tasks takes a task_type plus the target it applies to:
string
required
library_scan, live_tv_refresh, detect_markers (intro and credits detection) or segment_pregenerate
string
string
string
string

Metrics

GET /api/admin/metrics returns a snapshot for the dashboard: cpu, memory, network, the server process’s own process_cpu and process_memory, active connections, and a timestamp.

Updates

For zip installs. Package-managed installs (apt, dnf, Homebrew) refuse these and tell you to upgrade with the package manager. See Updating.

Linked account

Links the server to a kernelmedia.tv account, which is what unlocks Pro features.