Sonarr

App · 16 actions

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.

Actions

ActionWhat it does
Add seriesAdd 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.
Delete seriesDelete a series from Sonarr, and its downloaded files if asked.
Find seriesSearch TheTVDB through Sonarr for a series to add, by name or ID, with whether each one is already in Sonarr.
Get calendarList the episodes that air in the coming days, such as this week's, for a digest, soonest first.
Get disk spaceGet the free space on each disk Sonarr uses, and its root folders.
Get healthGet Sonarr's health warnings and errors, such as an indexer or download client it can't reach, with its version.
Get seriesGet a series in Sonarr with its episode counts by season: how many are downloaded and missing, its size, and when the next one airs.
List episodesList a series' episodes in order, with whether each is downloaded: all, only missing, only downloaded or only those not aired yet.
List historyList what Sonarr did, newest first: episodes grabbed, imported, failed or deleted, for a series or since a time, such as last week's downloads.
List missing episodesList the episodes that have aired but aren't downloaded, newest first, as Sonarr's Wanted > Missing does.
List queueList what Sonarr is downloading and importing, with progress and any warning, such as a download stuck because it can't be imported.
List seriesList the series in Sonarr with their episode counts, by title, status, monitored, tag or missing episodes.
Refresh seriesHave Sonarr update a series' details and episodes from TheTVDB and rescan its folder for files, or every series.
Remove from queueTake a download off Sonarr's queue, such as a stuck one, and optionally blocklist the release so Sonarr looks for another.
Search for episodesHave Sonarr search its indexers and download what it finds: every missing episode, or a series, a season or one episode.
Update seriesChange a series in Sonarr: whether it's monitored, its quality profile, and its tags.

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

SeriesseriestextRequired
A series name, such as Severance or The Office (2001) with its year, or its TVDB ID (371980) or IMDb ID.
Quality profilequality_profiletext
Which qualities to download, such as HD-1080p. Leave blank for the one most of your series use.
Root folderroot_foldertext
The folder to put it in. Leave blank for Sonarr's first root folder.
Monitormonitortext
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 typeseries_typetext
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 foldersseason_folderstrue/false
Put each season in a folder of its own.Default: true.
Tagstagstext
Tags to give it, separated by commas, such as requests. New names are made.
Search for missing episodessearch_for_missingtrue/false
Start searching for the episodes it's missing as soon as it's added.Default: true.

Outputs

addedtext
When it was added to Sonarr (ISO 8601, UTC)
already_addedtrue/false
True when the series was already in Sonarr and left as it was
episode_countnumber
Episodes Sonarr wants: monitored ones that have aired, and any downloaded
episode_file_countnumber
Of those, how many are downloaded
first_airedtext
When it first aired (ISO 8601, UTC)
genreslist
Its genres
idnumber
The series' ID in Sonarr
imdb_idtext
Its IMDb ID, such as tt0290978
missing_episodesnumber
Wanted episodes not downloaded yet
monitoredtrue/false
True while Sonarr watches for its episodes
networktext
The TV network or streaming service, such as BBC Two
next_airingtext
When its next episode airs (ISO 8601, UTC); empty for none
overviewtext
What it's about
pathtext
The folder its episodes are kept in
percent_completenumber
The share of wanted episodes downloaded, in percent
poster_urltext
Its poster image
previous_airingtext
When its last episode aired (ISO 8601, UTC)
quality_profiletext
The quality profile's name, such as HD-1080p
quality_profile_idnumber
The quality profile's ID
search_startedtrue/false
True when Sonarr started searching for its missing episodes
season_countnumber
How many seasons it has
series_typetext
standard, daily or anime
sizetext
The same, readable, such as 12.4 GB
size_on_disknumber
Bytes its files take on disk
statustext
continuing, ended or upcoming
tagslist
Its tags' names
titletext
The series' title
total_episode_countnumber
Every episode, specials included
tvdb_idnumber
Its ID on TheTVDB
urltext
Its page in Sonarr
yearnumber
The year it first aired
Example output
{
  "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

SeriesseriestextRequired
The series in Sonarr: pick it, or type its title or ID.
Delete its filesdelete_filestrue/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 againadd_exclusiontrue/false
Stop Sonarr's import lists adding it again.Default: false.

Outputs

deletedtrue/false
True when Sonarr deleted it; false when it wasn't there
files_deletedtrue/false
True when its files were deleted from disk too
pathtext
The folder its episodes were kept in
series_idnumber
The series' ID
titletext
The series' title
Example output
{
  "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

SeriesseriestextRequired
A series name, such as Severance, or its TVDB ID (371980) or IMDb ID (tt11280740).
How manylimitnumber
The most matches to list. Defaults to 10.From 1 to 50.

Outputs

countnumber
How many series were found
matcheslist
The series found, best match first
termtext
What Sonarr was asked for, such as tvdb:371980
Example output
{
  "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

Fromstartdate
The first day. Leave blank for today (UTC).
Daysdaysnumber
How many days to read. Defaults to 7.From 1 to 90.
Include unmonitoredinclude_unmonitoredtrue/false
Also list episodes Sonarr isn't watching for.Default: false.

Outputs

countnumber
How many episodes air
endtext
The end of the days read (ISO 8601, UTC)
episodeslist
The episodes, soonest first
starttext
The start of the days read (ISO 8601, UTC)
Example output
{
  "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

countnumber
How many disks Sonarr sees
diskslist
The disks
lowest_percent_freenumber
The least free space on any disk, in percent
root_folderslist
Sonarr's root folders
Example output
{
  "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

countnumber
How many issues there are
errorsnumber
How many issues are errors
healthytrue/false
True when Sonarr reports no issues
instance_nametext
Sonarr's name, from Settings > General
issueslist
The issues
versiontext
Sonarr's version
warningsnumber
How many issues are warnings
Example output
{
  "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

SeriesseriestextRequired
The series in Sonarr: pick it, or type its title or ID.

Outputs

addedtext
When it was added to Sonarr (ISO 8601, UTC)
episode_countnumber
Episodes Sonarr wants: monitored ones that have aired, and any downloaded
episode_file_countnumber
Of those, how many are downloaded
first_airedtext
When it first aired (ISO 8601, UTC)
genreslist
Its genres
idnumber
The series' ID in Sonarr
imdb_idtext
Its IMDb ID, such as tt0290978
missing_episodesnumber
Wanted episodes not downloaded yet
monitoredtrue/false
True while Sonarr watches for its episodes
networktext
The TV network or streaming service, such as BBC Two
next_airingtext
When its next episode airs (ISO 8601, UTC); empty for none
overviewtext
What it's about
pathtext
The folder its episodes are kept in
percent_completenumber
The share of wanted episodes downloaded, in percent
poster_urltext
Its poster image
previous_airingtext
When its last episode aired (ISO 8601, UTC)
quality_profiletext
The quality profile's name, such as HD-1080p
quality_profile_idnumber
The quality profile's ID
season_countnumber
How many seasons it has
seasonslist
Its seasons, with episode counts
series_typetext
standard, daily or anime
sizetext
The same, readable, such as 12.4 GB
size_on_disknumber
Bytes its files take on disk
statustext
continuing, ended or upcoming
tagslist
Its tags' names
titletext
The series' title
total_episode_countnumber
Every episode, specials included
tvdb_idnumber
Its ID on TheTVDB
urltext
Its page in Sonarr
yearnumber
The year it first aired
Example output
{
  "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

SeriesseriestextRequired
The series in Sonarr: pick it, or type its title or ID.
Seasonseasonnumber
A season number, such as 2; 0 is specials.From 0 to 1000.
Whichwhichtext
Which episodes to list.One of: all, missing (Missing (aired, monitored, not downloaded)), downloaded, upcoming (Not aired yet). Default: all.
How manylimitnumber
The most to list. Defaults to 250.From 1 to 1000.

Outputs

countnumber
How many episodes are listed
episodeslist
The episodes, in order
series_idnumber
The series' ID
series_titletext
The series' title
totalnumber
How many match, before the limit
Example output
{
  "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

Eventeventtext
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.
Seriesseriestext
Only this series.
Sincesincetext
Only events since then: how far back, such as 24h or 7d, or a date and time (UTC).
How manylimitnumber
The most to list. Defaults to 50.From 1 to 250.

Outputs

countnumber
How many events are listed
recordslist
The events, newest first
totalnumber
How many events match, before the limit
Example output
{
  "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 unmonitoredinclude_unmonitoredtrue/false
Also list episodes Sonarr isn't watching for.Default: false.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 250.

Outputs

countnumber
How many episodes are listed
episodeslist
The missing episodes, newest first
totalnumber
How many episodes are missing in all
Example output
{
  "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

Showstatustext
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 manylimitnumber
The most to list. Defaults to 50.From 1 to 250.

Outputs

countnumber
How many items are listed
itemslist
The queue's items
totalnumber
How many items match, before the limit
Example output
{
  "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

Searchsearchtext
Only series with these words in the title.
Statusstatustext
Only continuing, ended or upcoming series.One of: any, continuing, ended, upcoming. Default: any.
Monitoredmonitoredtext
Only monitored series, or only those that aren't.One of: any, monitored, unmonitored (Not monitored). Default: any.
Tagtagtext
Only series with this tag.
Only with missing episodesmissing_onlytrue/false
Only series with aired episodes not downloaded yet.Default: false.
Sort bysorttext
The order to list them in.One of: title, added (Newest added), next_airing (Next to air), missing (Most missing episodes). Default: title.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 250.

Outputs

countnumber
How many series are listed
serieslist
The series
totalnumber
How many match, before the limit
Example output
{
  "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

Seriesseriestext
The series to refresh. Leave blank for every series.

Outputs

commandtext
What Sonarr is doing, such as Series Search
command_idnumber
The command's ID in Sonarr
ended_attext
When Sonarr finished it (ISO 8601, UTC)
finishedtrue/false
True once Sonarr has finished it
messagetext
Sonarr's own words, such as '0 reports downloaded'
queued_attext
When it was asked for (ISO 8601, UTC)
resulttext
successful or unsuccessful, once finished
series_idnumber
The series' ID; 0 for every series
series_titletext
The series' title; empty for every series
started_attext
When Sonarr started it (ISO 8601, UTC)
statustext
queued, started, completed or failed
Example output
{
  "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 itemitemtextRequired
The queue item's ID, from List queue.
Remove from download clientremove_from_clienttrue/false
Also remove the download, and its files, from the download client.Default: true.
Blocklist releaseblocklisttrue/false
Never download this release again.Default: false.
Search for anothersearch_againtrue/false
When blocklisting, search for another release straight away.Default: true.

Outputs

blocklistedtrue/false
True when the release was blocklisted
idnumber
The queue item's ID
removedtrue/false
True when it was taken off the queue; false when it wasn't there
series_titletext
Its series' title
titletext
The release's name
Example output
{
  "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

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

Outputs

commandtext
What Sonarr is doing, such as Series Search
command_idnumber
The command's ID in Sonarr
ended_attext
When Sonarr finished it (ISO 8601, UTC)
episode_idslist
The IDs of the episodes searched for, for one episode
finishedtrue/false
True once Sonarr has finished it
messagetext
Sonarr's own words, such as '0 reports downloaded'
queued_attext
When it was asked for (ISO 8601, UTC)
resulttext
successful or unsuccessful, once finished
searchedtext
What was searched for, such as 'Severance season 2'
series_idnumber
The series' ID; 0 for every series
series_titletext
The series' title; empty for every series
started_attext
When Sonarr started it (ISO 8601, UTC)
statustext
queued, started, completed or failed
Example output
{
  "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

SeriesseriestextRequired
The series in Sonarr: pick it, or type its title or ID.
Monitoredmonitoredtext
Watch for its episodes, or stop.One of: keep (Leave as it is), monitor (Monitored), unmonitor (Not monitored). Default: keep.
Quality profilequality_profiletext
A new quality profile. Leave blank to keep it.
Add tagsadd_tagstext
Tags to give it, separated by commas. New names are made.
Remove tagsremove_tagstext
Tags to take off it, separated by commas.

Outputs

addedtext
When it was added to Sonarr (ISO 8601, UTC)
changeslist
What changed, such as 'tag kids added'
episode_countnumber
Episodes Sonarr wants: monitored ones that have aired, and any downloaded
episode_file_countnumber
Of those, how many are downloaded
first_airedtext
When it first aired (ISO 8601, UTC)
genreslist
Its genres
idnumber
The series' ID in Sonarr
imdb_idtext
Its IMDb ID, such as tt0290978
missing_episodesnumber
Wanted episodes not downloaded yet
monitoredtrue/false
True while Sonarr watches for its episodes
networktext
The TV network or streaming service, such as BBC Two
next_airingtext
When its next episode airs (ISO 8601, UTC); empty for none
overviewtext
What it's about
pathtext
The folder its episodes are kept in
percent_completenumber
The share of wanted episodes downloaded, in percent
poster_urltext
Its poster image
previous_airingtext
When its last episode aired (ISO 8601, UTC)
quality_profiletext
The quality profile's name, such as HD-1080p
quality_profile_idnumber
The quality profile's ID
season_countnumber
How many seasons it has
series_typetext
standard, daily or anime
sizetext
The same, readable, such as 12.4 GB
size_on_disknumber
Bytes its files take on disk
statustext
continuing, ended or upcoming
tagslist
Its tags' names
titletext
The series' title
total_episode_countnumber
Every episode, specials included
tvdb_idnumber
Its ID on TheTVDB
urltext
Its page in Sonarr
yearnumber
The year it first aired
Example output
{
  "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
}

On this page