List all series in the Sonarr library as compact summaries (id, title, year, status, monitored, quality profile, path, statistics). Use get_series for the full object with seasons, images and alternate titles.

Get the full series object for one series, including seasons with their per-season statistics and monitored flags.

Search TVDB for series to add, by title or by an id term such as 'tvdb:121361' or 'imdb:tt0944947'. Returns candidates with tvdbId, title, year and overview — pass the tvdbId to add_series.

Add a new series to the library by TVDB id. Resolves the series metadata via lookup, then posts it with the given root folder and quality profile. Use list_root_folders and list_quality_profiles first to get valid ids.

Update settings on an existing series. Fetches the current series, merges the given fields and puts it back — only the fields you pass are changed.

Remove a series from the library. Optionally delete its files from disk and add an import list exclusion so lists do not re-add it.

Apply the same change to many series at once (the series editor): monitoring, quality profile, series type, season folders, root folder or tags.

Remove many series from the library at once, optionally deleting their files and adding import list exclusions.

Get the folder path Sonarr would use for a series, given the current naming configuration.

Monitor or unmonitor whole seasons of a series. Pass season numbers (0 is specials); omit them to apply to every season.

List episodes as compact summaries (id, season/episode number, title, air date, hasFile, monitored). Filter by series, season or episode file. Use get_episode for the full object.

Get the full episode object, including the overview and the linked episode file with its quality and media info.

Monitor or unmonitor individual episodes. Use set_season_monitored for whole seasons.

List episode files on disk for a series, with path, size, quality, languages and release group.

Get a single episode file, including its full media info.

Delete one episode file from disk. The episode stays in the library and becomes missing.

Delete several episode files from disk in one call.

Change the recorded quality, languages, release group or scene name of existing episode files (the file editor). Does not touch the files on disk.

List episodes airing in a date range — what aired recently and what is coming up. Defaults to today and tomorrow on the Sonarr side.

List the download queue — everything Sonarr is currently downloading or waiting to import, with progress, status and any error messages.

Get the full, unpaged queue with per-episode detail. Useful for finding the queue item id of a specific episode.

Get queue counts by state — total, errors, warnings and how many items need manual interaction.

Remove one item from the queue, optionally also removing it from the download client and blocklisting the release so it is not grabbed again.

Remove several queue items at once, with the same options as remove_queue_item.

Force Sonarr to import a queue item that is stuck pending or waiting on manual interaction.

Force import of several stuck queue items at once.

Page through the grab and import history — what was grabbed, imported, failed, deleted or renamed, and from which indexer.

Get every history record since a date, unpaged. Useful for 'what happened since yesterday' style questions.

Get the full history for one series, optionally narrowed to a single season.

Mark a grabbed history item as failed. Sonarr blocklists the release and searches for a replacement.

Page through monitored episodes that have already aired but have no file — the wanted/missing list.

Page through episodes that have a file but have not reached their quality profile cutoff — candidates for an upgrade.

Page through blocklisted releases — releases Sonarr has been told never to grab again, with the reason they were blocked.

Remove one release from the blocklist so Sonarr may grab it again.

Remove several releases from the blocklist at once.

List commands Sonarr is currently running or has recently run, with their status and duration.

Get the status of a single command by id — poll this after starting a search or refresh.

Queue any Sonarr command by name. Known names: RefreshSeries, RescanSeries, EpisodeSearch, SeasonSearch, SeriesSearch, MissingEpisodeSearch, CutoffUnmetEpisodeSearch, DownloadedEpisodesScan, RenameFiles, RenameSeries, RssSync, RefreshMonitoredDownloads, ImportListSync, ManualImport, ClearBlocklist, CheckHealth, Housekeeping, Backup, ApplicationUpdate. Prefer the dedicated tools (refresh_series, search_series, ...) where one exists.

Cancel a queued or running command.

Refresh metadata from TVDB for one series, or for the whole library when no id is given.

Rescan the folder of one series (or all series) to pick up files added or removed outside Sonarr.

Start an automatic search for all monitored missing episodes of a series.

Start an automatic search for one season of a series.

Start an automatic search for specific episodes. Use search_releases first if you want to pick a release by hand.

List Sonarr's scheduled maintenance tasks with their interval and last and next execution times.

Get a single scheduled task by id.

Run an interactive indexer search and return the releases found, with quality, size, seeders, custom format score and any rejection reasons. Pass the guid and indexerId of the one you want to grab_release. This can take a while — indexers are queried live.

Send a release from search_releases to the download client.

List files in a folder or a stuck download with the series and episodes Sonarr would map them to, plus any rejection reasons. Use this to diagnose imports that need manual interaction.

Preview which existing files would be renamed under the current naming configuration, showing the old and new paths. Run the RenameFiles command to apply.

Parse a release title or file path the way Sonarr does, showing the series, season and episodes it maps to and the detected quality.

List quality profiles with their id, name, cutoff and the qualities each one allows. Series are assigned a profile by id.

Get one quality profile in full, including every quality item and custom format score.

Get a blank quality profile with every quality Sonarr knows about — the template for create_quality_profile.

Create a quality profile. Start from get_quality_profile_schema, set name, cutoff and which items are allowed.

Update a quality profile. Fetch it with get_quality_profile, change what you need and send the whole object back.

Delete a quality profile. It must not be in use by any series.

List quality definitions — the size limits (min, max, preferred MB per minute) Sonarr applies to each quality.

Update the size limits of one or more quality definitions. Send the full definition objects from list_quality_definitions with minSize, maxSize or preferredSize changed.

List custom formats with their specifications. Custom format scores in a quality profile decide which releases are preferred.

Get one custom format with its full specification list.

List the specification types a custom format can use (release title regex, size, language, quality modifier, ...) with their fields.

Create a custom format. Build the specifications from get_custom_format_schema.

Update a custom format. Fetch it first and send the whole object back.

Delete a custom format.

List release profiles — the required, ignored and preferred term rules applied to release titles.

Create a release profile, e.g. { name, enabled: true, required: [], ignored: ['x265'], indexerId: 0, tags: [] }.

Update a release profile. Fetch it from list_release_profiles and send the whole object back.

Delete a release profile.

List delay profiles — how long Sonarr waits for a better release before grabbing, per protocol and tag.

List the languages Sonarr knows, with the ids used in language profiles and episode file edits.

List the configured indexers. Secret field values are masked by Sonarr; the 'fields' array is omitted here — use get_indexer for it.

Get one indexer including its full 'fields' array (the implementation-specific settings).

List every indexer implementation Sonarr supports, with the fields each one takes. Use this as the template for create_indexer.

Add a new indexer. Build the body from get_indexer_schema: it needs name, implementation, configContract and the fields array, plus enableRss, enableAutomaticSearch, enableInteractiveSearch, priority, protocol.

Update an existing indexer. Fetch it with get_indexer first, change what you need and send the whole object back.

Delete a indexer.

Test a indexer configuration without saving it. Pass a config object to test a draft, or an id to test an existing one.

List the configured download clients. Secret field values are masked by Sonarr; the 'fields' array is omitted here — use get_download_client for it.

Get one download client including its full 'fields' array (the implementation-specific settings).

List every download client implementation Sonarr supports, with the fields each one takes. Use this as the template for create_download_client.

Add a new download client. Build the body from get_download_client_schema: it needs name, implementation, configContract and the fields array, plus enable, protocol, priority, removeCompletedDownloads, removeFailedDownloads.

Update an existing download client. Fetch it with get_download_client first, change what you need and send the whole object back.

Delete a download client.

Test a download client configuration without saving it. Pass a config object to test a draft, or an id to test an existing one.

List the configured import lists. Secret field values are masked by Sonarr; the 'fields' array is omitted here — use get_import_list for it.

Get one import list including its full 'fields' array (the implementation-specific settings).

List every import list implementation Sonarr supports, with the fields each one takes. Use this as the template for create_import_list.

Add a new import list. Build the body from get_import_list_schema: it needs name, implementation, configContract and the fields array, plus enableAutomaticAdd, shouldMonitor, rootFolderPath, qualityProfileId, seriesType.

Update an existing import list. Fetch it with get_import_list first, change what you need and send the whole object back.

Delete a import list.

Test a import list configuration without saving it. Pass a config object to test a draft, or an id to test an existing one.

List the configured notification connections. Secret field values are masked by Sonarr; the 'fields' array is omitted here — use get_notification for it.

Get one notification connection including its full 'fields' array (the implementation-specific settings).

List every notification connection implementation Sonarr supports, with the fields each one takes. Use this as the template for create_notification.

Add a new notification connection. Build the body from get_notification_schema: it needs name, implementation, configContract and the fields array, plus onGrab, onDownload, onUpgrade, onHealthIssue and the other event toggles.

Update an existing notification connection. Fetch it with get_notification first, change what you need and send the whole object back.

Delete a notification connection.

Test a notification connection configuration without saving it. Pass a config object to test a draft, or an id to test an existing one.

List root folders with their free space and any unmapped folders sitting in them. add_series needs one of these paths.

Get one root folder including the full list of unmapped folders — series folders on disk that are not in the library.

Add a root folder. The path must exist and be writable by Sonarr.

Remove a root folder from Sonarr. Files on disk are not touched.

List tags with their ids and labels. Tags link series to delay profiles, release profiles, indexers and notifications.

List tags together with everything using them — series ids, indexer ids, notification ids and profile ids.

Create a tag.

Rename a tag.

Delete a tag. It is removed from every series and provider using it.

List series excluded from import lists — series that lists will never re-add.

Exclude a series from import lists by TVDB id, so lists stop re-adding it.

Remove an import list exclusion so lists may add the series again.

List remote path mappings — how paths reported by a download client on another host translate to paths Sonarr can read.

Add a remote path mapping for a download client host.

Delete a remote path mapping.

Get the file and folder naming configuration.

Update the file and folder naming configuration. Fetch it with get_naming_config first, change what you need and send the whole object back.

Get the media management (import, file handling, permissions) configuration.

Update the media management (import, file handling, permissions) configuration. Fetch it with get_media_management_config first, change what you need and send the whole object back.

Get the indexer (RSS interval, retention, availability delay) configuration.

Update the indexer (RSS interval, retention, availability delay) configuration. Fetch it with get_indexer_config first, change what you need and send the whole object back.

Get the download client (completed and failed download handling) configuration.

Update the download client (completed and failed download handling) configuration. Fetch it with get_download_client_config first, change what you need and send the whole object back.

Get the import list configuration.

Update the import list configuration. Fetch it with get_import_list_config first, change what you need and send the whole object back.

Get the host (port, URL base, proxy, logging) configuration.

Get the UI (date format, first day of week) configuration.

Preview the filenames a naming format would produce, without saving it. Pass a naming config object to try a draft format.

Get version, branch, runtime, install source, OS and the paths Sonarr is using. Start here when diagnosing anything.

Get the active health check warnings and errors, with the wiki link explaining each one.

Get free and total space for every drive and root folder Sonarr can see.

List available Sonarr updates for the current branch, with changelogs and whether each is installed or installable.

Page through Sonarr's log entries, newest first by default. Filter by level to find errors quickly.

List the log files on disk with their names, sizes and download paths.

Download the contents of one log file as text.

List the database backups Sonarr has taken, with their type, size and date. Run the Backup command to create a new one.

Restart the Sonarr application. It is unreachable for a few seconds afterwards.