Radarr
App · 17 actions
Run your movie collection in Radarr from workflows: add movies from requests, forms or watchlists, look up and list movies, search, refresh, tag and delete them, get upcoming releases for a digest, and see missing movies, the download queue, history, health and disk space. Start a workflow when a movie is downloaded, grabbed or added, or Radarr reports a health issue.
Actions
| Action | What it does |
|---|---|
| Add movie | Add a movie to Radarr by its title (and year), TMDB ID or IMDb ID, with a quality profile, and have Radarr search for it. |
| Add tags to movie | Give a movie one or more tags, making any Radarr doesn't have. |
| Delete movie | Remove a movie from Radarr. |
| Get disk space | Get the free space on every disk Radarr can see and in its root folders, such as to warn before the library fills up. |
| Get health | Get the warnings and errors Radarr's health check reports (an indexer or download client it can't reach, a missing root folder, an update), and its version. |
| Get movie | Get a movie in Radarr's library: whether it's downloaded and its file's quality and size, whether it's monitored, its release dates and its tags. |
| Get upcoming releases | List the movies in Radarr that open in cinemas or come out digitally or on disc in the next few days, soonest first, as Radarr's Calendar shows them. |
| List history | List what Radarr did, newest first: releases grabbed, downloads imported or failed, files deleted or renamed, for a movie or all, such as this week's downloads. |
| List missing movies | List the monitored movies Radarr has no file of yet, as Wanted > Missing shows them, by title. |
| List movies | List the movies in Radarr's library, by words in the title, downloaded or missing, monitored, or tag, with their status and file. |
| List queue | List the downloads in Radarr's queue with their progress and time left, and which are stuck (a warning, an error, or an import Radarr can't finish) and why. |
| Look up movies | Find movies on TMDB through Radarr by title, TMDB ID or IMDb ID, with their year, release dates and whether they're in the library, such as to pick one before adding it. |
| Refresh movie | Have Radarr update a movie's details from TMDB and rescan its folder for files, such as after adding a file by hand; or refresh every movie. |
| Remove from queue | Remove a download from Radarr's queue, such as a stuck one, and from the download client; optionally blocklist the release so Radarr searches for another. |
| Remove tags from movie | Take one or more tags off a movie. |
| Search for movie | Have Radarr search its indexers for a movie now and grab the best release its quality profile allows, as its Search button does; or search for every missing movie. |
| Update movie | Change whether Radarr monitors a movie, its quality profile or its minimum availability, such as to stop looking once it's downloaded. |
Add movie
Add a movie to Radarr by its title (and year), TMDB ID or IMDb ID, with a quality profile, and have Radarr search for it. One already in the library is returned as it is.
Inputs
- Title
titletext - The movie's title, such as The Matrix. A TMDB or IMDb link works too. Leave blank when giving a TMDB or IMDb ID.
- Year
yearnumber - The year it came out, to pick the right one of movies with the same title.From 1870 to 2200.
- TMDB ID
tmdb_idnumber - The movie's TMDB ID, such as 603 (the number in its themoviedb.org address). Used instead of the title.At least 1.
- IMDb ID
imdb_idtext - The movie's IMDb ID, such as tt0133093. Used instead of the title.
- Quality profile
quality_profiletextRequired - The quality profile, which decides what quality Radarr downloads, such as HD-1080p.
- Root folder
root_foldertext - The folder to put it in, such as /movies. Leave blank when Radarr has only one.
- Minimum availability
minimum_availabilitytext - When Radarr starts looking for it: once it's announced, in cinemas, or released (on disc or digitally).One of:
announced,inCinemas(In Cinemas),released. Default:released. - Monitored
monitoredtrue/false - Have Radarr look for it and its upgrades. Off adds it without downloading anything.Default:
true. - Search on add
search_on_addtrue/false - Search for it straight away, rather than waiting for a new release to turn up.Default:
true. - Tags
tagstext - Tag names to give it, separated by commas, such as kids. Tags Radarr doesn't have are made.
Outputs
addedtext- When it was added to Radarr (UTC)
already_addedtrue/false- Whether it was already in the library, left as it was
availabletrue/false- Whether it has reached its minimum availability
certificationtext- Its rating, such as PG-13
digital_releasetext- When it came out digitally (UTC)
downloadedtrue/false- Whether Radarr has a file of it
fileobject- Its file, when it has one
genreslist- Its genres
idnumber- The movie's ID in Radarr, for other Radarr steps
imdb_idtext- Its IMDb ID, such as tt0133093
in_cinemastext- When it opened in cinemas (UTC)
linktext- A link to it in Radarr
minimum_availabilitytext- When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false- Whether Radarr looks for it and its upgrades
overviewtext- What it's about
pathtext- Its folder on Radarr's server
physical_releasetext- When it came out on disc (UTC)
poster_urltext- A link to its poster
quality_profiletext- Its quality profile's name
quality_profile_idnumber- Its quality profile's ID
ratingnumber- Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext- The root folder it's in
runtime_minutesnumber- How long it runs, in minutes
searchingtrue/false- Whether Radarr started searching for it
size_on_disknumber- How many bytes its files take
statustext- announced, inCinemas, released, tba or deleted
studiotext- Its studio
tagslist- Its tags' names
titletext- Its title
tmdb_idnumber- Its TMDB ID
tmdb_linktext- A link to it on TMDB
yearnumber- Its year
Example output
{
"added": "2026-11-08T20:02:44Z",
"already_added": false,
"available": true,
"certification": "R",
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": false,
"file": {
"added": "",
"edition": "",
"id": 0,
"path": "",
"quality": "",
"relative_path": "",
"release_group": "",
"size": 0,
"size_text": ""
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"searching": true,
"size_on_disk": 0,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}Add tags to movie
Give a movie one or more tags, making any Radarr doesn't have. Tags it already has stay.
Inputs
- Movie
movietextRequired - The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
- Tags
tagstextRequired - Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.
Outputs
addedtext- When it was added to Radarr (UTC)
availabletrue/false- Whether it has reached its minimum availability
certificationtext- Its rating, such as PG-13
changed_tagslist- The tags added (or removed) by this step
digital_releasetext- When it came out digitally (UTC)
downloadedtrue/false- Whether Radarr has a file of it
fileobject- Its file, when it has one
genreslist- Its genres
idnumber- The movie's ID in Radarr, for other Radarr steps
imdb_idtext- Its IMDb ID, such as tt0133093
in_cinemastext- When it opened in cinemas (UTC)
linktext- A link to it in Radarr
minimum_availabilitytext- When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false- Whether Radarr looks for it and its upgrades
overviewtext- What it's about
pathtext- Its folder on Radarr's server
physical_releasetext- When it came out on disc (UTC)
poster_urltext- A link to its poster
quality_profiletext- Its quality profile's name
quality_profile_idnumber- Its quality profile's ID
ratingnumber- Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext- The root folder it's in
runtime_minutesnumber- How long it runs, in minutes
size_on_disknumber- How many bytes its files take
statustext- announced, inCinemas, released, tba or deleted
studiotext- Its studio
tagslist- Its tags' names
titletext- Its title
tmdb_idnumber- Its TMDB ID
tmdb_linktext- A link to it on TMDB
yearnumber- Its year
Example output
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"changed_tags": [
"kids"
],
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": true,
"file": {
"added": "2026-11-08T21:14:03Z",
"edition": "",
"id": 7,
"path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
"quality": "Bluray-1080p",
"relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
"release_group": "SPARKS",
"size": 8804682752,
"size_text": "8.2 GB"
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 8804682752,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [
"family",
"kids"
],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}Delete movie
Remove a movie from Radarr. Its files stay on disk unless Delete files is on, which deletes them for good and can't be undone.
Inputs
- Movie
movietextRequired - The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
- Delete files
delete_filestrue/false - Also delete the movie's folder and files from disk. This can't be undone.Default:
false. - Exclude from import lists
add_exclusiontrue/false - Keep Radarr's import lists from adding it again.Default:
false.
Outputs
deletedtrue/false- True: it's out of Radarr
excludedtrue/false- Whether it's kept out of import lists
files_deletedtrue/false- Whether its files were deleted from disk
idnumber- The movie's ID in Radarr, which is gone now
titletext- Its title
tmdb_idnumber- Its TMDB ID
yearnumber- Its year
Example output
{
"deleted": true,
"excluded": false,
"files_deleted": false,
"id": 1,
"title": "The Matrix",
"tmdb_id": 603,
"year": 1999
}Get disk space
Get the free space on every disk Radarr can see and in its root folders, such as to warn before the library fills up.
Inputs
None.
Outputs
countnumber- How many disks Radarr reports
diskslist- Every disk Radarr can see
lowest_percent_freenumber- The least free space on any disk, in percent
root_folderslist- The root folders movies go in
Example output
{
"count": 1,
"disks": [
{
"free": "1.2 TB",
"free_bytes": 1319413953331,
"label": "",
"path": "/movies",
"percent_free": 30.0,
"total": "4.0 TB",
"total_bytes": 4398046511104
}
],
"lowest_percent_free": 30.0,
"root_folders": [
{
"accessible": true,
"free": "1.2 TB",
"free_bytes": 1319413953331,
"path": "/movies",
"unmapped_folders": 0
}
]
}Get health
Get the warnings and errors Radarr's health check reports (an indexer or download client it can't reach, a missing root folder, an update), and its version.
Inputs
None.
Outputs
errorsnumber- How many errors
healthytrue/false- True when Radarr reports no warnings or errors
instance_nametext- Radarr's name, as set under Settings > General
issueslist- What Radarr's health check reports
linktext- A link to Radarr's System > Status page
startedtext- When Radarr last started (UTC)
versiontext- Radarr's version
warningsnumber- How many warnings
Example output
{
"errors": 0,
"healthy": false,
"instance_name": "Radarr",
"issues": [
{
"message": "Unable to communicate with qBittorrent.",
"source": "DownloadClientCheck",
"type": "warning",
"wiki_url": "https://wiki.servarr.com/radarr/system#download-clients"
}
],
"link": "http://192.168.1.20:7878/system/status",
"started": "2026-11-09T18:59:48Z",
"version": "6.4.4.10685",
"warnings": 1
}Get movie
Get a movie in Radarr's library: whether it's downloaded and its file's quality and size, whether it's monitored, its release dates and its tags.
Inputs
- Movie
movietextRequired - The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
Outputs
addedtext- When it was added to Radarr (UTC)
availabletrue/false- Whether it has reached its minimum availability
certificationtext- Its rating, such as PG-13
digital_releasetext- When it came out digitally (UTC)
downloadedtrue/false- Whether Radarr has a file of it
fileobject- Its file, when it has one
genreslist- Its genres
idnumber- The movie's ID in Radarr, for other Radarr steps
imdb_idtext- Its IMDb ID, such as tt0133093
in_cinemastext- When it opened in cinemas (UTC)
linktext- A link to it in Radarr
minimum_availabilitytext- When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false- Whether Radarr looks for it and its upgrades
overviewtext- What it's about
pathtext- Its folder on Radarr's server
physical_releasetext- When it came out on disc (UTC)
poster_urltext- A link to its poster
quality_profiletext- Its quality profile's name
quality_profile_idnumber- Its quality profile's ID
ratingnumber- Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext- The root folder it's in
runtime_minutesnumber- How long it runs, in minutes
size_on_disknumber- How many bytes its files take
statustext- announced, inCinemas, released, tba or deleted
studiotext- Its studio
tagslist- Its tags' names
titletext- Its title
tmdb_idnumber- Its TMDB ID
tmdb_linktext- A link to it on TMDB
yearnumber- Its year
Example output
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": true,
"file": {
"added": "2026-11-08T21:14:03Z",
"edition": "",
"id": 7,
"path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
"quality": "Bluray-1080p",
"relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
"release_group": "SPARKS",
"size": 8804682752,
"size_text": "8.2 GB"
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 8804682752,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [
"family"
],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}Get upcoming releases
List the movies in Radarr that open in cinemas or come out digitally or on disc in the next few days, soonest first, as Radarr's Calendar shows them. For a weekly digest.
Inputs
- Days ahead
daysnumber - How many days ahead to look. Defaults to 7.From 1 to 365.
- Include unmonitored
include_unmonitoredtrue/false - Also list movies Radarr isn't monitoring.Default:
false.
Outputs
countnumber- How many movies have a release then
endtext- To when (UTC)
movieslist- The movies, soonest release first
starttext- From when (UTC)
Example output
{
"count": 1,
"end": "2026-12-08T09:00:00Z",
"movies": [
{
"added": "2026-11-08T20:02:44Z",
"available": false,
"certification": "R",
"digital_release": "",
"downloaded": false,
"file": {
"added": "",
"edition": "",
"id": 0,
"path": "",
"quality": "",
"relative_path": "",
"release_group": "",
"size": 0,
"size_text": ""
},
"genres": [
"Action",
"Science Fiction"
],
"id": 3,
"imdb_id": "tt21357150",
"in_cinemas": "2026-12-04T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/1003596",
"minimum_availability": "released",
"monitored": true,
"next_release": "In cinemas",
"next_release_date": "2026-12-04T00:00:00Z",
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"releases": [
{
"date": "2026-12-04T00:00:00Z",
"label": "In cinemas",
"type": "in_cinemas"
}
],
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 0,
"status": "announced",
"studio": "Village Roadshow Pictures",
"tags": [
"family"
],
"title": "Avengers: Doomsday",
"tmdb_id": 1003596,
"tmdb_link": "https://www.themoviedb.org/movie/1003596",
"year": 2026
}
],
"start": "2026-12-01T09:00:00Z"
}List history
List what Radarr did, newest first: releases grabbed, downloads imported or failed, files deleted or renamed, for a movie or all, such as this week's downloads.
Inputs
- Event
eventtext - Only events of this kind.One of:
any,grabbed(Grabbed (sent to the download client)),downloaded(Downloaded and imported),failed(Download failed),file_deleted(File deleted),folder_imported(Imported from the movie's folder),renamed(File renamed),ignored(Download ignored). Default:any. - Movie
movietext - Only events for this movie.
- Within the last (days)
daysnumber - Only events from the last this many days.From 1 to 3650.
- How many
limitnumber - The most to list. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
eventslist- The events, newest first
Example output
{
"count": 1,
"events": [
{
"date": "2026-11-09T19:12:10Z",
"download_client": "qBittorrent",
"download_id": "0123456789ABCDEF0123456789ABCDEF01234567",
"event": "downloaded",
"id": 42,
"imdb_id": "tt0133093",
"imported_path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv",
"indexer": "",
"link": "http://192.168.1.20:7878/movie/603",
"movie_id": 1,
"movie_title": "The Matrix",
"movie_year": 1999,
"quality": "Bluray-1080p",
"reason": "",
"release_title": "The.Matrix.1999.1080p.BluRay.x264-GROUP",
"size": 0,
"tmdb_id": 603
}
]
}List missing movies
List the monitored movies Radarr has no file of yet, as Wanted > Missing shows them, by title.
Inputs
- Only released
only_availabletrue/false - Only movies that have reached their minimum availability, so Radarr could download them now. Off includes those not out yet.Default:
true. - How many
limitnumber - The most to list. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
monitored_missingnumber- How many monitored movies have no file, released or not
movieslist- The missing movies, by title
Example output
{
"count": 1,
"monitored_missing": 3,
"movies": [
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": false,
"file": {
"added": "",
"edition": "",
"id": 0,
"path": "",
"quality": "",
"relative_path": "",
"release_group": "",
"size": 0,
"size_text": ""
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 0,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [
"family"
],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}
]
}List movies
List the movies in Radarr's library, by words in the title, downloaded or missing, monitored, or tag, with their status and file.
Inputs
- Search
searchtext - Only movies with these words in the title.
- Downloaded
downloadedtext - Only movies Radarr has a file of, or only those it hasn't.One of:
any,downloaded(Downloaded (has a file)),missing(Missing (no file yet)). Default:any. - Monitored
monitoredtext - Only monitored movies, or only those that aren't.One of:
any,monitored,unmonitored(Not monitored). Default:any. - Tag
tagtext - Only movies with this tag.
- Sort by
sorttext - The order to list them in.One of:
title,added(Newest added first),year(Newest year first). Default:title. - How many
limitnumber - The most to list. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
movieslist- The movies
totalnumber- How many match in all
Example output
{
"count": 1,
"movies": [
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": true,
"file": {
"added": "2026-11-08T21:14:03Z",
"edition": "",
"id": 7,
"path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
"quality": "Bluray-1080p",
"relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
"release_group": "SPARKS",
"size": 8804682752,
"size_text": "8.2 GB"
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 8804682752,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [
"family"
],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}
],
"total": 1
}List queue
List the downloads in Radarr's queue with their progress and time left, and which are stuck (a warning, an error, or an import Radarr can't finish) and why.
Inputs
- Only stuck downloads
only_stucktrue/false - Only downloads that need a person.Default:
false. - How many
limitnumber - The most to list. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
itemslist- The downloads
stucknumber- How many need a person
totalnumber- How many downloads are in the queue (that match)
Example output
{
"count": 1,
"items": [
{
"added": "2026-11-09T19:03:50Z",
"download_client": "qBittorrent",
"download_id": "0123456789ABCDEF0123456789ABCDEF01234567",
"estimated_completion": "2026-11-09T19:06:45Z",
"health": "warning",
"id": 1506557212,
"indexer": "Example Indexer",
"messages": [
"The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv: Not an upgrade"
],
"movie_id": 1,
"movie_title": "The Matrix",
"movie_year": 1999,
"output_path": "/downloads/The.Matrix.1999.1080p.BluRay.x264-GROUP",
"progress_percent": 100.0,
"protocol": "torrent",
"quality": "Bluray-1080p",
"size": 8804682752,
"size_left": 0,
"state": "importBlocked",
"status": "completed",
"stuck": true,
"time_left": "00:00:00",
"title": "The.Matrix.1999.1080p.BluRay.x264-GROUP"
}
],
"stuck": 1,
"total": 1
}Look up movies
Find movies on TMDB through Radarr by title, TMDB ID or IMDb ID, with their year, release dates and whether they're in the library, such as to pick one before adding it.
Inputs
- Title or ID
termtextRequired - A title, such as The Matrix, or tmdb:603, or an IMDb ID such as tt0133093.
- How many
limitnumber - The most to list. Defaults to 10.From 1 to 50.
Outputs
countnumber- How many are listed
movieslist- The movies found, best match first
termtext- What was looked up
totalnumber- How many were found
Example output
{
"count": 1,
"movies": [
{
"digital_release": "2001-03-19T00:00:00Z",
"genres": [
"Action",
"Science Fiction"
],
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"in_library": false,
"link": "",
"movie_id": 0,
"overview": "A computer hacker learns the true nature of his reality.",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"rating": 8.7,
"runtime_minutes": 136,
"status": "released",
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}
],
"term": "The Matrix",
"total": 1
}Refresh movie
Have Radarr update a movie's details from TMDB and rescan its folder for files, such as after adding a file by hand; or refresh every movie.
Inputs
- Movie
movietext - The movie to refresh. Leave blank to refresh every movie, which can take a while.
Outputs
commandtext- The task, such as Movies Search
command_idnumber- Radarr's ID for the task
endedtext- When it finished (UTC)
finishedtrue/false- Whether it finished while the step waited
messagetext- What Radarr said when it finished
movie_idnumber- The movie's ID in Radarr; 0 for every movie
movie_titletext- The movie's title; blank for every movie
queuedtext- When it was queued (UTC)
startedtext- When it started (UTC)
statustext- queued, started or completed
Example output
{
"command": "Refresh Movie",
"command_id": 813,
"ended": "2026-11-09T19:09:51Z",
"finished": true,
"message": "Completed",
"movie_id": 1,
"movie_title": "The Matrix",
"queued": "2026-11-09T19:09:47Z",
"started": "2026-11-09T19:09:47Z",
"status": "completed"
}Remove from queue
Remove a download from Radarr's queue, such as a stuck one, and from the download client; optionally blocklist the release so Radarr searches for another.
Inputs
- Download
itemtextRequired - The download: its ID in the queue (from List queue) or its release name.
- Remove from download client
remove_from_clienttrue/false - Also remove it, and what it downloaded, from the download client. Off leaves it there and Radarr stops tracking it.Default:
true. - Blocklist release
blocklisttrue/false - Never grab this release again, and search for another.Default:
false.
Outputs
blocklistedtrue/false- Whether the release was blocklisted
idnumber- The download's ID in the queue
movie_idnumber- The movie's ID in Radarr
movie_titletext- The movie's title
removedtrue/false- True: it's out of the queue
removed_from_clienttrue/false- Whether it was removed from the download client too
titletext- The release's name
Example output
{
"blocklisted": false,
"id": 1506557212,
"movie_id": 1,
"movie_title": "The Matrix",
"removed": true,
"removed_from_client": true,
"title": "The.Matrix.1999.1080p.BluRay.x264-GROUP"
}Remove tags from movie
Take one or more tags off a movie. The tags stay in Radarr for other movies.
Inputs
- Movie
movietextRequired - The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
- Tags
tagstextRequired - Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.
Outputs
addedtext- When it was added to Radarr (UTC)
availabletrue/false- Whether it has reached its minimum availability
certificationtext- Its rating, such as PG-13
changed_tagslist- The tags added (or removed) by this step
digital_releasetext- When it came out digitally (UTC)
downloadedtrue/false- Whether Radarr has a file of it
fileobject- Its file, when it has one
genreslist- Its genres
idnumber- The movie's ID in Radarr, for other Radarr steps
imdb_idtext- Its IMDb ID, such as tt0133093
in_cinemastext- When it opened in cinemas (UTC)
linktext- A link to it in Radarr
minimum_availabilitytext- When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false- Whether Radarr looks for it and its upgrades
overviewtext- What it's about
pathtext- Its folder on Radarr's server
physical_releasetext- When it came out on disc (UTC)
poster_urltext- A link to its poster
quality_profiletext- Its quality profile's name
quality_profile_idnumber- Its quality profile's ID
ratingnumber- Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext- The root folder it's in
runtime_minutesnumber- How long it runs, in minutes
size_on_disknumber- How many bytes its files take
statustext- announced, inCinemas, released, tba or deleted
studiotext- Its studio
tagslist- Its tags' names
titletext- Its title
tmdb_idnumber- Its TMDB ID
tmdb_linktext- A link to it on TMDB
yearnumber- Its year
Example output
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"changed_tags": [
"family"
],
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": true,
"file": {
"added": "2026-11-08T21:14:03Z",
"edition": "",
"id": 7,
"path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
"quality": "Bluray-1080p",
"relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
"release_group": "SPARKS",
"size": 8804682752,
"size_text": "8.2 GB"
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": true,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 8804682752,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}Search for movie
Have Radarr search its indexers for a movie now and grab the best release its quality profile allows, as its Search button does; or search for every missing movie.
Inputs
- Movie
movietext - The movie to search for. Leave blank to search for every monitored movie that's missing.
Outputs
commandtext- The task, such as Movies Search
command_idnumber- Radarr's ID for the task
endedtext- When it finished (UTC)
finishedtrue/false- Whether it finished while the step waited
messagetext- What Radarr said when it finished
movie_idnumber- The movie's ID in Radarr; 0 for every movie
movie_titletext- The movie's title; blank for every movie
queuedtext- When it was queued (UTC)
startedtext- When it started (UTC)
statustext- queued, started or completed
Example output
{
"command": "Movies Search",
"command_id": 812,
"ended": "2026-11-09T19:09:51Z",
"finished": true,
"message": "Completed",
"movie_id": 1,
"movie_title": "The Matrix",
"queued": "2026-11-09T19:09:47Z",
"started": "2026-11-09T19:09:47Z",
"status": "completed"
}Update movie
Change whether Radarr monitors a movie, its quality profile or its minimum availability, such as to stop looking once it's downloaded. Blank fields stay as they are.
Inputs
- Movie
movietextRequired - The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
- Monitored
monitoredtrue/false - On to have Radarr look for it and its upgrades, off to stop. Leave blank to keep it.
- Quality profile
quality_profiletext - A new quality profile, such as Ultra-HD. Leave blank to keep it.
- Minimum availability
minimum_availabilitytext - When Radarr starts looking for it: once it's announced, in cinemas, or released (on disc or digitally). Leave blank to keep it.One of:
announced,inCinemas(In Cinemas),released.
Outputs
addedtext- When it was added to Radarr (UTC)
availabletrue/false- Whether it has reached its minimum availability
certificationtext- Its rating, such as PG-13
changedlist- What changed, such as monitored
digital_releasetext- When it came out digitally (UTC)
downloadedtrue/false- Whether Radarr has a file of it
fileobject- Its file, when it has one
genreslist- Its genres
idnumber- The movie's ID in Radarr, for other Radarr steps
imdb_idtext- Its IMDb ID, such as tt0133093
in_cinemastext- When it opened in cinemas (UTC)
linktext- A link to it in Radarr
minimum_availabilitytext- When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false- Whether Radarr looks for it and its upgrades
overviewtext- What it's about
pathtext- Its folder on Radarr's server
physical_releasetext- When it came out on disc (UTC)
poster_urltext- A link to its poster
quality_profiletext- Its quality profile's name
quality_profile_idnumber- Its quality profile's ID
ratingnumber- Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext- The root folder it's in
runtime_minutesnumber- How long it runs, in minutes
size_on_disknumber- How many bytes its files take
statustext- announced, inCinemas, released, tba or deleted
studiotext- Its studio
tagslist- Its tags' names
titletext- Its title
tmdb_idnumber- Its TMDB ID
tmdb_linktext- A link to it on TMDB
yearnumber- Its year
Example output
{
"added": "2026-11-08T20:02:44Z",
"available": true,
"certification": "R",
"changed": [
"monitored"
],
"digital_release": "2001-03-19T00:00:00Z",
"downloaded": true,
"file": {
"added": "2026-11-08T21:14:03Z",
"edition": "",
"id": 7,
"path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
"quality": "Bluray-1080p",
"relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
"release_group": "SPARKS",
"size": 8804682752,
"size_text": "8.2 GB"
},
"genres": [
"Action",
"Science Fiction"
],
"id": 1,
"imdb_id": "tt0133093",
"in_cinemas": "1999-03-31T00:00:00Z",
"link": "http://192.168.1.20:7878/movie/603",
"minimum_availability": "released",
"monitored": false,
"overview": "A computer hacker learns the true nature of his reality.",
"path": "/movies/The Matrix (1999)",
"physical_release": "1999-11-25T00:00:00Z",
"poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
"quality_profile": "HD-1080p",
"quality_profile_id": 4,
"rating": 8.7,
"root_folder": "/movies",
"runtime_minutes": 136,
"size_on_disk": 8804682752,
"status": "released",
"studio": "Village Roadshow Pictures",
"tags": [
"family"
],
"title": "The Matrix",
"tmdb_id": 603,
"tmdb_link": "https://www.themoviedb.org/movie/603",
"year": 1999
}