> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kernelmedia.tv/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin API

> Manage a Kernel server over HTTP

The admin API is what Kernel's own web admin uses to manage the server: settings, users, Live TV, recordings, remote transcoders and imports. Everything the admin pages can do, you can script.

## Authentication

Admin endpoints use the same token as the rest of the API (see [Authentication](https://docs.kernelmedia.tv/api-reference/introduction.md#authentication)), but the token must belong to a user with **admin** rights. A valid token for a non-admin user is rejected.

```bash theme={null}
curl http://<server>:9014/api/admin/settings \
  -H "Authorization: Bearer <admin-jwt>"
```

Errors use the same `{"error": "..."}` shape as the client API.

> [!WARNING]
>
> An admin token can change every setting, user and source on the server. Keep it out of shared scripts and logs.

## Sections

> [card] [Server & Settings](https://docs.kernelmedia.tv/api-reference/admin/server.md)
>
> Settings, tasks, metrics, updates, hot reload, linked account

> [card] [Users](https://docs.kernelmedia.tv/api-reference/admin/users.md)
>
> Library access and Live TV permissions

> [card] [Live TV](https://docs.kernelmedia.tv/api-reference/admin/live-tv.md)
>
> Sources, EPG, categories, mapping, bitrate fallback, sports logos

> [card] [Recordings & Markers](https://docs.kernelmedia.tv/api-reference/admin/recordings.md)
>
> Recordings, commercial cutting, intro/credits detection

> [card] [Remote Transcoders](https://docs.kernelmedia.tv/api-reference/admin/remote-transcoders.md)
>
> Authorize, rename and configure nodes

> [card] [Plex & Jellyfin Import](https://docs.kernelmedia.tv/api-reference/admin/import.md)
>
> Bring over Libraries, Users, Watch History, Watchlists and Show Themes

> [card] [Radarr & Sonarr](https://docs.kernelmedia.tv/api-reference/admin/arr.md)
>
> Request defaults for watchlist requests

## New in 0.9.0

| Endpoint | Page |
| - | - |
| `POST /api/admin/server/reload` | [Server & Settings](https://docs.kernelmedia.tv/api-reference/admin/server.md#hot-reload) |
| `GET /api/admin/library-counts`, `PUT /libraries/order` | [Server & Settings](https://docs.kernelmedia.tv/api-reference/admin/server.md#libraries) |
| `PUT /api/admin/users/{userId}/permissions` | [Users](https://docs.kernelmedia.tv/api-reference/admin/users.md) |
| `/api/admin/livetv/start-times`, `/api/admin/livetv/team-logos/*` | [Live TV](https://docs.kernelmedia.tv/api-reference/admin/live-tv.md) |
| `/api/admin/recordings/{id}/commercials`, `/api/admin/markers/failures*` | [Recordings & Markers](https://docs.kernelmedia.tv/api-reference/admin/recordings.md) |
| `/api/admin/import/*`, `/api/user/me/plex-sync` | [Plex & Jellyfin Import](https://docs.kernelmedia.tv/api-reference/admin/import.md) |
| `/api/admin/arr/*` | [Radarr & Sonarr](https://docs.kernelmedia.tv/api-reference/admin/arr.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.