# Sonarr

> Manage TV series in Sonarr: add a series with its quality and folder, search for missing episodes, read this week's calendar, the download queue and history, and check health and disk space. Start a workflow when an episode is downloaded or grabbed, a series is added, or Sonarr raises a health warning.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/sonarr

## Actions

### Add series

Add a TV series to Sonarr by name or TVDB ID, choosing its quality, folder and which episodes to watch for, and start searching for the missing ones. One already in Sonarr is left as it is.

**Inputs**

- Series (`series`, text, required): A series name, such as Severance or The Office (2001) with its year, or its TVDB ID (371980) or IMDb ID.
- Quality profile (`quality_profile`, text): Which qualities to download, such as HD-1080p. Leave blank for the one most of your series use.
- Root folder (`root_folder`, text): The folder to put it in. Leave blank for Sonarr's first root folder.
- Monitor (`monitor`, text): Which episodes Sonarr watches for and downloads. One of: `all` (All episodes), `future` (Future episodes), `missing` (Missing episodes), `existing` (Existing episodes), `recent` (Recent episodes), `pilot` (Pilot episode), `firstSeason` (First season), `lastSeason` (Last season), `none`. Default: `all`.
- Series type (`series_type`, text): How its episodes are numbered: by season (most series), by date (daily shows) or absolute (anime). One of: `standard` (Standard (S01E05)), `daily` (Daily (by date)), `anime` (Anime (absolute numbers)). Default: `standard`.
- Season folders (`season_folders`, true/false): Put each season in a folder of its own. Default: `true`.
- Tags (`tags`, text): Tags to give it, separated by commas, such as requests. New names are made.
- Search for missing episodes (`search_for_missing`, true/false): Start searching for the episodes it's missing as soon as it's added. Default: `true`.

**Outputs**

- `added` (text): When it was added to Sonarr (ISO 8601, UTC)
- `already_added` (true/false): True when the series was already in Sonarr and left as it was
- `episode_count` (number): Episodes Sonarr wants: monitored ones that have aired, and any downloaded
- `episode_file_count` (number): Of those, how many are downloaded
- `first_aired` (text): When it first aired (ISO 8601, UTC)
- `genres` (list): Its genres
- `id` (number): The series' ID in Sonarr
- `imdb_id` (text): Its IMDb ID, such as tt0290978
- `missing_episodes` (number): Wanted episodes not downloaded yet
- `monitored` (true/false): True while Sonarr watches for its episodes
- `network` (text): The TV network or streaming service, such as BBC Two
- `next_airing` (text): When its next episode airs (ISO 8601, UTC); empty for none
- `overview` (text): What it's about
- `path` (text): The folder its episodes are kept in
- `percent_complete` (number): The share of wanted episodes downloaded, in percent
- `poster_url` (text): Its poster image
- `previous_airing` (text): When its last episode aired (ISO 8601, UTC)
- `quality_profile` (text): The quality profile's name, such as HD-1080p
- `quality_profile_id` (number): The quality profile's ID
- `search_started` (true/false): True when Sonarr started searching for its missing episodes
- `season_count` (number): How many seasons it has
- `series_type` (text): standard, daily or anime
- `size` (text): The same, readable, such as 12.4 GB
- `size_on_disk` (number): Bytes its files take on disk
- `status` (text): continuing, ended or upcoming
- `tags` (list): Its tags' names
- `title` (text): The series' title
- `total_episode_count` (number): Every episode, specials included
- `tvdb_id` (number): Its ID on TheTVDB
- `url` (text): Its page in Sonarr
- `year` (number): The year it first aired

**Example output**

```json
{
  "added": "2026-11-02T18:20:00Z",
  "already_added": false,
  "episode_count": 21,
  "episode_file_count": 19,
  "first_aired": "2022-02-18T00:00:00Z",
  "genres": [
    "Drama",
    "Mystery",
    "Science Fiction"
  ],
  "id": 12,
  "imdb_id": "tt11280740",
  "missing_episodes": 2,
  "monitored": true,
  "network": "Apple TV+",
  "next_airing": "2026-11-14T02:00:00Z",
  "overview": "Mark leads a team of office workers whose memories have been surgically divided between their work and personal lives.",
  "path": "/tv/Severance",
  "percent_complete": 90.5,
  "poster_url": "https://artworks.thetvdb.com/banners/posters/371980-1.jpg",
  "previous_airing": "2026-11-07T02:00:00Z",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "search_started": true,
  "season_count": 3,
  "series_type": "standard",
  "size": "39.0 GB",
  "size_on_disk": 41875931136,
  "status": "continuing",
  "tags": [
    "requests"
  ],
  "title": "Severance",
  "total_episode_count": 24,
  "tvdb_id": 371980,
  "url": "http://192.168.1.10:8989/series/severance",
  "year": 2022
}
```

### Delete series

Delete a series from Sonarr, and its downloaded files if asked. This can't be undone: deleted files are gone. Nothing is deleted when it isn't there.

**Inputs**

- Series (`series`, text, required): The series in Sonarr: pick it, or type its title or ID.
- Delete its files (`delete_files`, true/false): Also delete its folder and every episode file in it from disk. They can't be got back. Default: `false`.
- Don't add it again (`add_exclusion`, true/false): Stop Sonarr's import lists adding it again. Default: `false`.

**Outputs**

- `deleted` (true/false): True when Sonarr deleted it; false when it wasn't there
- `files_deleted` (true/false): True when its files were deleted from disk too
- `path` (text): The folder its episodes were kept in
- `series_id` (number): The series' ID
- `title` (text): The series' title

**Example output**

```json
{
  "deleted": true,
  "files_deleted": false,
  "path": "/tv/Severance",
  "series_id": 12,
  "title": "Severance"
}
```

### Find series

Search TheTVDB through Sonarr for a series to add, by name or ID, with whether each one is already in Sonarr.

**Inputs**

- Series (`series`, text, required): A series name, such as Severance, or its TVDB ID (371980) or IMDb ID (tt11280740).
- How many (`limit`, number): The most matches to list. Defaults to 10. From 1 to 50.

**Outputs**

- `count` (number): How many series were found
- `matches` (list): The series found, best match first
- `term` (text): What Sonarr was asked for, such as tvdb:371980

**Example output**

```json
{
  "count": 1,
  "matches": [
    {
      "first_aired": "2022-02-18T00:00:00Z",
      "genres": [
        "Drama",
        "Mystery",
        "Science Fiction"
      ],
      "imdb_id": "tt11280740",
      "in_library": false,
      "network": "Apple TV+",
      "overview": "Mark leads a team of office workers whose memories have been surgically divided between their work and personal lives.",
      "poster_url": "https://artworks.thetvdb.com/banners/posters/371980-1.jpg",
      "season_count": 3,
      "series_id": 0,
      "status": "continuing",
      "title": "Severance",
      "tvdb_id": 371980,
      "tvdb_url": "https://thetvdb.com/?tab=series&id=371980",
      "url": "",
      "year": 2022
    }
  ],
  "term": "Severance"
}
```

### Get calendar

List the episodes that air in the coming days, such as this week's, for a digest, soonest first.

**Inputs**

- From (`start`, date): The first day. Leave blank for today (UTC).
- Days (`days`, number): How many days to read. Defaults to 7. From 1 to 90.
- Include unmonitored (`include_unmonitored`, true/false): Also list episodes Sonarr isn't watching for. Default: `false`.

**Outputs**

- `count` (number): How many episodes air
- `end` (text): The end of the days read (ISO 8601, UTC)
- `episodes` (list): The episodes, soonest first
- `start` (text): The start of the days read (ISO 8601, UTC)

**Example output**

```json
{
  "count": 1,
  "end": "2026-11-16T00:00:00Z",
  "episodes": [
    {
      "air_date": "2026-11-13",
      "air_date_utc": "2026-11-14T02:00:00Z",
      "code": "S02E05",
      "episode_number": 5,
      "file_path": "",
      "has_file": false,
      "id": 4182,
      "monitored": true,
      "network": "Apple TV+",
      "overview": "Mark's team chases a lead.",
      "quality": "",
      "season_number": 2,
      "series_id": 12,
      "series_title": "Severance",
      "title": "Trojan's Horse"
    }
  ],
  "start": "2026-11-09T00:00:00Z"
}
```

### Get disk space

Get the free space on each disk Sonarr uses, and its root folders.

**Inputs**: None.

**Outputs**

- `count` (number): How many disks Sonarr sees
- `disks` (list): The disks
- `lowest_percent_free` (number): The least free space on any disk, in percent
- `root_folders` (list): Sonarr's root folders

**Example output**

```json
{
  "count": 1,
  "disks": [
    {
      "free": "678.4 GB",
      "free_bytes": 728383234048,
      "label": "media",
      "path": "/tv",
      "percent_free": 18.2,
      "total": "3.6 TB",
      "total_bytes": 4000787030016
    }
  ],
  "lowest_percent_free": 18.2,
  "root_folders": [
    {
      "accessible": true,
      "free": "678.4 GB",
      "free_bytes": 728383234048,
      "path": "/tv"
    }
  ]
}
```

### Get health

Get Sonarr's health warnings and errors, such as an indexer or download client it can't reach, with its version.

**Inputs**: None.

**Outputs**

- `count` (number): How many issues there are
- `errors` (number): How many issues are errors
- `healthy` (true/false): True when Sonarr reports no issues
- `instance_name` (text): Sonarr's name, from Settings > General
- `issues` (list): The issues
- `version` (text): Sonarr's version
- `warnings` (number): How many issues are warnings

**Example output**

```json
{
  "count": 1,
  "errors": 0,
  "healthy": false,
  "instance_name": "Sonarr",
  "issues": [
    {
      "level": "warning",
      "message": "Unable to communicate with qBittorrent.",
      "source": "DownloadClientCheck",
      "wiki_url": "https://wiki.servarr.com/sonarr/system#download-clients-are-unavailable-due-to-failures"
    }
  ],
  "version": "4.0.20.3014",
  "warnings": 1
}
```

### Get series

Get a series in Sonarr with its episode counts by season: how many are downloaded and missing, its size, and when the next one airs.

**Inputs**

- Series (`series`, text, required): The series in Sonarr: pick it, or type its title or ID.

**Outputs**

- `added` (text): When it was added to Sonarr (ISO 8601, UTC)
- `episode_count` (number): Episodes Sonarr wants: monitored ones that have aired, and any downloaded
- `episode_file_count` (number): Of those, how many are downloaded
- `first_aired` (text): When it first aired (ISO 8601, UTC)
- `genres` (list): Its genres
- `id` (number): The series' ID in Sonarr
- `imdb_id` (text): Its IMDb ID, such as tt0290978
- `missing_episodes` (number): Wanted episodes not downloaded yet
- `monitored` (true/false): True while Sonarr watches for its episodes
- `network` (text): The TV network or streaming service, such as BBC Two
- `next_airing` (text): When its next episode airs (ISO 8601, UTC); empty for none
- `overview` (text): What it's about
- `path` (text): The folder its episodes are kept in
- `percent_complete` (number): The share of wanted episodes downloaded, in percent
- `poster_url` (text): Its poster image
- `previous_airing` (text): When its last episode aired (ISO 8601, UTC)
- `quality_profile` (text): The quality profile's name, such as HD-1080p
- `quality_profile_id` (number): The quality profile's ID
- `season_count` (number): How many seasons it has
- `seasons` (list): Its seasons, with episode counts
- `series_type` (text): standard, daily or anime
- `size` (text): The same, readable, such as 12.4 GB
- `size_on_disk` (number): Bytes its files take on disk
- `status` (text): continuing, ended or upcoming
- `tags` (list): Its tags' names
- `title` (text): The series' title
- `total_episode_count` (number): Every episode, specials included
- `tvdb_id` (number): Its ID on TheTVDB
- `url` (text): Its page in Sonarr
- `year` (number): The year it first aired

**Example output**

```json
{
  "added": "2026-11-02T18:20:00Z",
  "episode_count": 21,
  "episode_file_count": 19,
  "first_aired": "2022-02-18T00:00:00Z",
  "genres": [
    "Drama",
    "Mystery",
    "Science Fiction"
  ],
  "id": 12,
  "imdb_id": "tt11280740",
  "missing_episodes": 2,
  "monitored": true,
  "network": "Apple TV+",
  "next_airing": "2026-11-14T02:00:00Z",
  "overview": "Mark leads a team of office workers whose memories have been surgically divided between their work and personal lives.",
  "path": "/tv/Severance",
  "percent_complete": 90.5,
  "poster_url": "https://artworks.thetvdb.com/banners/posters/371980-1.jpg",
  "previous_airing": "2026-11-07T02:00:00Z",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "season_count": 3,
  "seasons": [
    {
      "episode_count": 10,
      "episode_file_count": 10,
      "monitored": true,
      "season_number": 1,
      "size_on_disk": 18253611008,
      "total_episode_count": 10
    },
    {
      "episode_count": 11,
      "episode_file_count": 9,
      "monitored": true,
      "season_number": 2,
      "size_on_disk": 23622320128,
      "total_episode_count": 14
    }
  ],
  "series_type": "standard",
  "size": "39.0 GB",
  "size_on_disk": 41875931136,
  "status": "continuing",
  "tags": [
    "requests"
  ],
  "title": "Severance",
  "total_episode_count": 24,
  "tvdb_id": 371980,
  "url": "http://192.168.1.10:8989/series/severance",
  "year": 2022
}
```

### List episodes

List a series' episodes in order, with whether each is downloaded: all, only missing, only downloaded or only those not aired yet.

**Inputs**

- Series (`series`, text, required): The series in Sonarr: pick it, or type its title or ID.
- Season (`season`, number): A season number, such as 2; 0 is specials. From 0 to 1000.
- Which (`which`, text): Which episodes to list. One of: `all`, `missing` (Missing (aired, monitored, not downloaded)), `downloaded`, `upcoming` (Not aired yet). Default: `all`.
- How many (`limit`, number): The most to list. Defaults to 250. From 1 to 1000.

**Outputs**

- `count` (number): How many episodes are listed
- `episodes` (list): The episodes, in order
- `series_id` (number): The series' ID
- `series_title` (text): The series' title
- `total` (number): How many match, before the limit

**Example output**

```json
{
  "count": 1,
  "episodes": [
    {
      "air_date": "2026-11-13",
      "air_date_utc": "2026-11-14T02:00:00Z",
      "code": "S02E05",
      "episode_number": 5,
      "file_path": "",
      "has_file": false,
      "id": 4182,
      "monitored": true,
      "overview": "Mark's team chases a lead.",
      "quality": "",
      "season_number": 2,
      "series_id": 12,
      "series_title": "Severance",
      "title": "Trojan's Horse"
    }
  ],
  "series_id": 12,
  "series_title": "Severance",
  "total": 1
}
```

### List history

List what Sonarr did, newest first: episodes grabbed, imported, failed or deleted, for a series or since a time, such as last week's downloads.

**Inputs**

- Event (`event`, text): Only this kind of event. One of: `any`, `grabbed` (Grabbed (sent to the download client)), `imported` (Imported (downloaded)), `failed` (Download failed), `deleted` (File deleted), `renamed` (File renamed), `ignored` (Download ignored). Default: `any`.
- Series (`series`, text): Only this series.
- Since (`since`, text): Only events since then: how far back, such as 24h or 7d, or a date and time (UTC).
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 250.

**Outputs**

- `count` (number): How many events are listed
- `records` (list): The events, newest first
- `total` (number): How many events match, before the limit

**Example output**

```json
{
  "count": 1,
  "records": [
    {
      "date": "2026-11-09T19:04:37Z",
      "download_client": "qBittorrent",
      "episode_code": "S02E05",
      "episode_id": 4182,
      "episode_number": 5,
      "episode_title": "Trojan's Horse",
      "event": "imported",
      "event_type": "downloadFolderImported",
      "id": 905,
      "imported_path": "/tv/Severance/Season 2/Severance - S02E05.mkv",
      "indexer": "",
      "message": "",
      "quality": "WEBDL-1080p",
      "release_group": "NTb",
      "release_title": "Severance.S02E05.1080p.ATVP.WEB-DL.DDP5.1.H.264-NTb",
      "season_number": 2,
      "series_id": 12,
      "series_title": "Severance",
      "size": "2.9 GB"
    }
  ],
  "total": 1
}
```

### List missing episodes

List the episodes that have aired but aren't downloaded, newest first, as Sonarr's Wanted > Missing does.

**Inputs**

- Include unmonitored (`include_unmonitored`, true/false): Also list episodes Sonarr isn't watching for. Default: `false`.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 250.

**Outputs**

- `count` (number): How many episodes are listed
- `episodes` (list): The missing episodes, newest first
- `total` (number): How many episodes are missing in all

**Example output**

```json
{
  "count": 1,
  "episodes": [
    {
      "air_date": "2026-11-06",
      "air_date_utc": "2026-11-07T02:00:00Z",
      "code": "S02E05",
      "episode_number": 5,
      "file_path": "",
      "has_file": false,
      "id": 4182,
      "monitored": true,
      "overview": "Mark's team chases a lead.",
      "quality": "",
      "season_number": 2,
      "series_id": 12,
      "series_title": "Severance",
      "title": "Trojan's Horse"
    }
  ],
  "total": 2
}
```

### List queue

List what Sonarr is downloading and importing, with progress and any warning, such as a download stuck because it can't be imported.

**Inputs**

- Show (`status`, text): Every item, only those with a problem, or only those still downloading. One of: `all`, `problems` (Only those with a warning or error), `downloading` (Only those still downloading). Default: `all`.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 250.

**Outputs**

- `count` (number): How many items are listed
- `items` (list): The queue's items
- `total` (number): How many items match, before the limit

**Example output**

```json
{
  "count": 1,
  "items": [
    {
      "download_client": "qBittorrent",
      "episode_code": "S02E05",
      "episode_id": 4182,
      "episode_title": "Trojan's Horse",
      "estimated_completion": "2026-11-09T19:04:19Z",
      "health": "warning",
      "id": 488657207,
      "indexer": "Example Indexer",
      "messages": [
        "Severance.S02E05.mkv: Unable to determine if file is a sample"
      ],
      "output_path": "/downloads/complete/Severance.S02E05",
      "progress": 100.0,
      "protocol": "torrent",
      "quality": "WEBDL-1080p",
      "series_id": 12,
      "series_title": "Severance",
      "size": "2.9 GB",
      "state": "importBlocked",
      "status": "completed",
      "time_left": "00:00:00",
      "title": "Severance.S02E05.1080p.ATVP.WEB-DL.DDP5.1.H.264-NTb"
    }
  ],
  "total": 1
}
```

### List series

List the series in Sonarr with their episode counts, by title, status, monitored, tag or missing episodes.

**Inputs**

- Search (`search`, text): Only series with these words in the title.
- Status (`status`, text): Only continuing, ended or upcoming series. One of: `any`, `continuing`, `ended`, `upcoming`. Default: `any`.
- Monitored (`monitored`, text): Only monitored series, or only those that aren't. One of: `any`, `monitored`, `unmonitored` (Not monitored). Default: `any`.
- Tag (`tag`, text): Only series with this tag.
- Only with missing episodes (`missing_only`, true/false): Only series with aired episodes not downloaded yet. Default: `false`.
- Sort by (`sort`, text): The order to list them in. One of: `title`, `added` (Newest added), `next_airing` (Next to air), `missing` (Most missing episodes). Default: `title`.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 250.

**Outputs**

- `count` (number): How many series are listed
- `series` (list): The series
- `total` (number): How many match, before the limit

**Example output**

```json
{
  "count": 1,
  "series": [
    {
      "added": "2026-11-02T18:20:00Z",
      "episode_count": 21,
      "episode_file_count": 19,
      "first_aired": "2022-02-18T00:00:00Z",
      "genres": [
        "Drama",
        "Mystery",
        "Science Fiction"
      ],
      "id": 12,
      "imdb_id": "tt11280740",
      "missing_episodes": 2,
      "monitored": true,
      "network": "Apple TV+",
      "next_airing": "2026-11-14T02:00:00Z",
      "overview": "Mark leads a team of office workers whose memories have been surgically divided between their work and personal lives.",
      "path": "/tv/Severance",
      "percent_complete": 90.5,
      "poster_url": "https://artworks.thetvdb.com/banners/posters/371980-1.jpg",
      "previous_airing": "2026-11-07T02:00:00Z",
      "quality_profile": "HD-1080p",
      "quality_profile_id": 4,
      "season_count": 3,
      "series_type": "standard",
      "size": "39.0 GB",
      "size_on_disk": 41875931136,
      "status": "continuing",
      "tags": [
        "requests"
      ],
      "title": "Severance",
      "total_episode_count": 24,
      "tvdb_id": 371980,
      "url": "http://192.168.1.10:8989/series/severance",
      "year": 2022
    }
  ],
  "total": 1
}
```

### Refresh series

Have Sonarr update a series' details and episodes from TheTVDB and rescan its folder for files, or every series.

**Inputs**

- Series (`series`, text): The series to refresh. Leave blank for every series.

**Outputs**

- `command` (text): What Sonarr is doing, such as Series Search
- `command_id` (number): The command's ID in Sonarr
- `ended_at` (text): When Sonarr finished it (ISO 8601, UTC)
- `finished` (true/false): True once Sonarr has finished it
- `message` (text): Sonarr's own words, such as '0 reports downloaded'
- `queued_at` (text): When it was asked for (ISO 8601, UTC)
- `result` (text): successful or unsuccessful, once finished
- `series_id` (number): The series' ID; 0 for every series
- `series_title` (text): The series' title; empty for every series
- `started_at` (text): When Sonarr started it (ISO 8601, UTC)
- `status` (text): queued, started, completed or failed

**Example output**

```json
{
  "command": "Refresh Series",
  "command_id": 318,
  "ended_at": "2026-11-09T19:05:31Z",
  "finished": true,
  "message": "",
  "queued_at": "2026-11-09T19:05:29Z",
  "result": "successful",
  "series_id": 12,
  "series_title": "Severance",
  "started_at": "2026-11-09T19:05:29Z",
  "status": "completed"
}
```

### Remove from queue

Take a download off Sonarr's queue, such as a stuck one, and optionally blocklist the release so Sonarr looks for another. Nothing is removed when it isn't there.

**Inputs**

- Queue item (`item`, text, required): The queue item's ID, from List queue.
- Remove from download client (`remove_from_client`, true/false): Also remove the download, and its files, from the download client. Default: `true`.
- Blocklist release (`blocklist`, true/false): Never download this release again. Default: `false`.
- Search for another (`search_again`, true/false): When blocklisting, search for another release straight away. Default: `true`.

**Outputs**

- `blocklisted` (true/false): True when the release was blocklisted
- `id` (number): The queue item's ID
- `removed` (true/false): True when it was taken off the queue; false when it wasn't there
- `series_title` (text): Its series' title
- `title` (text): The release's name

**Example output**

```json
{
  "blocklisted": true,
  "id": 488657207,
  "removed": true,
  "series_title": "Severance",
  "title": "Severance.S02E05.1080p.ATVP.WEB-DL.DDP5.1.H.264-NTb"
}
```

### Search for episodes

Have Sonarr search its indexers and download what it finds: every missing episode, or a series, a season or one episode.

**Inputs**

- Series (`series`, text): The series to search for. Leave blank for every missing episode Sonarr watches for.
- Season (`season`, number): A season number, such as 2; 0 is specials. From 0 to 1000.
- Episode (`episode`, number): One episode's number in the season, such as 5 (with Season 2 for S02E05). From 1 to 10000.

**Outputs**

- `command` (text): What Sonarr is doing, such as Series Search
- `command_id` (number): The command's ID in Sonarr
- `ended_at` (text): When Sonarr finished it (ISO 8601, UTC)
- `episode_ids` (list): The IDs of the episodes searched for, for one episode
- `finished` (true/false): True once Sonarr has finished it
- `message` (text): Sonarr's own words, such as '0 reports downloaded'
- `queued_at` (text): When it was asked for (ISO 8601, UTC)
- `result` (text): successful or unsuccessful, once finished
- `searched` (text): What was searched for, such as 'Severance season 2'
- `series_id` (number): The series' ID; 0 for every series
- `series_title` (text): The series' title; empty for every series
- `started_at` (text): When Sonarr started it (ISO 8601, UTC)
- `status` (text): queued, started, completed or failed

**Example output**

```json
{
  "command": "Series Search",
  "command_id": 318,
  "ended_at": "2026-11-09T19:05:31Z",
  "episode_ids": [],
  "finished": true,
  "message": "Series search completed. 1 reports downloaded.",
  "queued_at": "2026-11-09T19:05:29Z",
  "result": "successful",
  "searched": "Severance",
  "series_id": 12,
  "series_title": "Severance",
  "started_at": "2026-11-09T19:05:29Z",
  "status": "completed"
}
```

### Update series

Change a series in Sonarr: whether it's monitored, its quality profile, and its tags.

**Inputs**

- Series (`series`, text, required): The series in Sonarr: pick it, or type its title or ID.
- Monitored (`monitored`, text): Watch for its episodes, or stop. One of: `keep` (Leave as it is), `monitor` (Monitored), `unmonitor` (Not monitored). Default: `keep`.
- Quality profile (`quality_profile`, text): A new quality profile. Leave blank to keep it.
- Add tags (`add_tags`, text): Tags to give it, separated by commas. New names are made.
- Remove tags (`remove_tags`, text): Tags to take off it, separated by commas.

**Outputs**

- `added` (text): When it was added to Sonarr (ISO 8601, UTC)
- `changes` (list): What changed, such as 'tag kids added'
- `episode_count` (number): Episodes Sonarr wants: monitored ones that have aired, and any downloaded
- `episode_file_count` (number): Of those, how many are downloaded
- `first_aired` (text): When it first aired (ISO 8601, UTC)
- `genres` (list): Its genres
- `id` (number): The series' ID in Sonarr
- `imdb_id` (text): Its IMDb ID, such as tt0290978
- `missing_episodes` (number): Wanted episodes not downloaded yet
- `monitored` (true/false): True while Sonarr watches for its episodes
- `network` (text): The TV network or streaming service, such as BBC Two
- `next_airing` (text): When its next episode airs (ISO 8601, UTC); empty for none
- `overview` (text): What it's about
- `path` (text): The folder its episodes are kept in
- `percent_complete` (number): The share of wanted episodes downloaded, in percent
- `poster_url` (text): Its poster image
- `previous_airing` (text): When its last episode aired (ISO 8601, UTC)
- `quality_profile` (text): The quality profile's name, such as HD-1080p
- `quality_profile_id` (number): The quality profile's ID
- `season_count` (number): How many seasons it has
- `series_type` (text): standard, daily or anime
- `size` (text): The same, readable, such as 12.4 GB
- `size_on_disk` (number): Bytes its files take on disk
- `status` (text): continuing, ended or upcoming
- `tags` (list): Its tags' names
- `title` (text): The series' title
- `total_episode_count` (number): Every episode, specials included
- `tvdb_id` (number): Its ID on TheTVDB
- `url` (text): Its page in Sonarr
- `year` (number): The year it first aired

**Example output**

```json
{
  "added": "2026-11-02T18:20:00Z",
  "changes": [
    "tag kids added"
  ],
  "episode_count": 21,
  "episode_file_count": 19,
  "first_aired": "2022-02-18T00:00:00Z",
  "genres": [
    "Drama",
    "Mystery",
    "Science Fiction"
  ],
  "id": 12,
  "imdb_id": "tt11280740",
  "missing_episodes": 2,
  "monitored": true,
  "network": "Apple TV+",
  "next_airing": "2026-11-14T02:00:00Z",
  "overview": "Mark leads a team of office workers whose memories have been surgically divided between their work and personal lives.",
  "path": "/tv/Severance",
  "percent_complete": 90.5,
  "poster_url": "https://artworks.thetvdb.com/banners/posters/371980-1.jpg",
  "previous_airing": "2026-11-07T02:00:00Z",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "season_count": 3,
  "series_type": "standard",
  "size": "39.0 GB",
  "size_on_disk": 41875931136,
  "status": "continuing",
  "tags": [
    "requests"
  ],
  "title": "Severance",
  "total_episode_count": 24,
  "tvdb_id": 371980,
  "url": "http://192.168.1.10:8989/series/severance",
  "year": 2022
}
```
