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
| Action | What it does |
|---|---|
| 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. |
| Delete series | Delete a series from Sonarr, and its downloaded files if asked. |
| Find series | Search TheTVDB through Sonarr for a series to add, by name or ID, with whether each one is already in Sonarr. |
| Get calendar | List the episodes that air in the coming days, such as this week's, for a digest, soonest first. |
| Get disk space | Get the free space on each disk Sonarr uses, and its root folders. |
| Get health | Get Sonarr's health warnings and errors, such as an indexer or download client it can't reach, with its version. |
| 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. |
| List episodes | List a series' episodes in order, with whether each is downloaded: all, only missing, only downloaded or only those not aired yet. |
| 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. |
| List missing episodes | List the episodes that have aired but aren't downloaded, newest first, as Sonarr's Wanted > Missing does. |
| 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. |
| List series | List the series in Sonarr with their episode counts, by title, status, monitored, tag or missing episodes. |
| Refresh series | Have Sonarr update a series' details and episodes from TheTVDB and rescan its folder for files, or every series. |
| 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. |
| Search for episodes | Have Sonarr search its indexers and download what it finds: every missing episode, or a series, a season or one episode. |
| Update series | Change 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
- Series
seriestextRequired - A series name, such as Severance or The Office (2001) with its year, or its TVDB ID (371980) or IMDb ID.
- Quality profile
quality_profiletext - Which qualities to download, such as HD-1080p. Leave blank for the one most of your series use.
- Root folder
root_foldertext - The folder to put it in. Leave blank for Sonarr's first root folder.
- Monitor
monitortext - 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_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 folders
season_folderstrue/false - Put each season in a folder of its own.Default:
true. - Tags
tagstext - Tags to give it, separated by commas, such as requests. New names are made.
- Search for missing episodes
search_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
- Series
seriestextRequired - The series in Sonarr: pick it, or type its title or ID.
- Delete its files
delete_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 again
add_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
- Series
seriestextRequired - A series name, such as Severance, or its TVDB ID (371980) or IMDb ID (tt11280740).
- How many
limitnumber - 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
- From
startdate - The first day. Leave blank for today (UTC).
- Days
daysnumber - How many days to read. Defaults to 7.From 1 to 90.
- Include unmonitored
include_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
- Series
seriestextRequired - 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
- Series
seriestextRequired - The series in Sonarr: pick it, or type its title or ID.
- Season
seasonnumber - A season number, such as 2; 0 is specials.From 0 to 1000.
- Which
whichtext - Which episodes to list.One of:
all,missing(Missing (aired, monitored, not downloaded)),downloaded,upcoming(Not aired yet). Default:all. - How many
limitnumber - 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
- Event
eventtext - 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
seriestext - Only this series.
- Since
sincetext - Only events since then: how far back, such as 24h or 7d, or a date and time (UTC).
- How many
limitnumber - 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 unmonitored
include_unmonitoredtrue/false - Also list episodes Sonarr isn't watching for.Default:
false. - How many
limitnumber - 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
- Show
statustext - 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
limitnumber - 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
- Search
searchtext - Only series with these words in the title.
- Status
statustext - Only continuing, ended or upcoming series.One of:
any,continuing,ended,upcoming. Default:any. - Monitored
monitoredtext - Only monitored series, or only those that aren't.One of:
any,monitored,unmonitored(Not monitored). Default:any. - Tag
tagtext - Only series with this tag.
- Only with missing episodes
missing_onlytrue/false - Only series with aired episodes not downloaded yet.Default:
false. - Sort by
sorttext - 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
limitnumber - 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
- Series
seriestext - 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 item
itemtextRequired - The queue item's ID, from List queue.
- Remove from download client
remove_from_clienttrue/false - Also remove the download, and its files, from the download client.Default:
true. - Blocklist release
blocklisttrue/false - Never download this release again.Default:
false. - Search for another
search_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
- Series
seriestext - The series to search for. Leave blank for every missing episode Sonarr watches for.
- Season
seasonnumber - A season number, such as 2; 0 is specials.From 0 to 1000.
- Episode
episodenumber - 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
- Series
seriestextRequired - The series in Sonarr: pick it, or type its title or ID.
- Monitored
monitoredtext - Watch for its episodes, or stop.One of:
keep(Leave as it is),monitor(Monitored),unmonitor(Not monitored). Default:keep. - Quality profile
quality_profiletext - A new quality profile. Leave blank to keep it.
- Add tags
add_tagstext - Tags to give it, separated by commas. New names are made.
- Remove tags
remove_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
}