# Radarr

> 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.

App · 17 actions. Web page: https://docs.lodol.com/docs/integrations/radarr

## Actions

### 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 (`title`, text): 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 (`year`, number): The year it came out, to pick the right one of movies with the same title. From 1870 to 2200.
- TMDB ID (`tmdb_id`, number): 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_id`, text): The movie's IMDb ID, such as tt0133093. Used instead of the title.
- Quality profile (`quality_profile`, text, required): The quality profile, which decides what quality Radarr downloads, such as HD-1080p.
- Root folder (`root_folder`, text): The folder to put it in, such as /movies. Leave blank when Radarr has only one.
- Minimum availability (`minimum_availability`, text): 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 (`monitored`, true/false): Have Radarr look for it and its upgrades. Off adds it without downloading anything. Default: `true`.
- Search on add (`search_on_add`, true/false): Search for it straight away, rather than waiting for a new release to turn up. Default: `true`.
- Tags (`tags`, text): Tag names to give it, separated by commas, such as kids. Tags Radarr doesn't have are made.

**Outputs**

- `added` (text): When it was added to Radarr (UTC)
- `already_added` (true/false): Whether it was already in the library, left as it was
- `available` (true/false): Whether it has reached its minimum availability
- `certification` (text): Its rating, such as PG-13
- `digital_release` (text): When it came out digitally (UTC)
- `downloaded` (true/false): Whether Radarr has a file of it
- `file` (object): Its file, when it has one
- `genres` (list): Its genres
- `id` (number): The movie's ID in Radarr, for other Radarr steps
- `imdb_id` (text): Its IMDb ID, such as tt0133093
- `in_cinemas` (text): When it opened in cinemas (UTC)
- `link` (text): A link to it in Radarr
- `minimum_availability` (text): When Radarr starts looking: announced, inCinemas or released
- `monitored` (true/false): Whether Radarr looks for it and its upgrades
- `overview` (text): What it's about
- `path` (text): Its folder on Radarr's server
- `physical_release` (text): When it came out on disc (UTC)
- `poster_url` (text): A link to its poster
- `quality_profile` (text): Its quality profile's name
- `quality_profile_id` (number): Its quality profile's ID
- `rating` (number): Its IMDb rating out of 10 (TMDB's when IMDb has none)
- `root_folder` (text): The root folder it's in
- `runtime_minutes` (number): How long it runs, in minutes
- `searching` (true/false): Whether Radarr started searching for it
- `size_on_disk` (number): How many bytes its files take
- `status` (text): announced, inCinemas, released, tba or deleted
- `studio` (text): Its studio
- `tags` (list): Its tags' names
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `tmdb_link` (text): A link to it on TMDB
- `year` (number): Its year

**Example output**

```json
{
  "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 (`movie`, text, required): 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 (`tags`, text, required): Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.

**Outputs**

- `added` (text): When it was added to Radarr (UTC)
- `available` (true/false): Whether it has reached its minimum availability
- `certification` (text): Its rating, such as PG-13
- `changed_tags` (list): The tags added (or removed) by this step
- `digital_release` (text): When it came out digitally (UTC)
- `downloaded` (true/false): Whether Radarr has a file of it
- `file` (object): Its file, when it has one
- `genres` (list): Its genres
- `id` (number): The movie's ID in Radarr, for other Radarr steps
- `imdb_id` (text): Its IMDb ID, such as tt0133093
- `in_cinemas` (text): When it opened in cinemas (UTC)
- `link` (text): A link to it in Radarr
- `minimum_availability` (text): When Radarr starts looking: announced, inCinemas or released
- `monitored` (true/false): Whether Radarr looks for it and its upgrades
- `overview` (text): What it's about
- `path` (text): Its folder on Radarr's server
- `physical_release` (text): When it came out on disc (UTC)
- `poster_url` (text): A link to its poster
- `quality_profile` (text): Its quality profile's name
- `quality_profile_id` (number): Its quality profile's ID
- `rating` (number): Its IMDb rating out of 10 (TMDB's when IMDb has none)
- `root_folder` (text): The root folder it's in
- `runtime_minutes` (number): How long it runs, in minutes
- `size_on_disk` (number): How many bytes its files take
- `status` (text): announced, inCinemas, released, tba or deleted
- `studio` (text): Its studio
- `tags` (list): Its tags' names
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `tmdb_link` (text): A link to it on TMDB
- `year` (number): Its year

**Example output**

```json
{
  "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 (`movie`, text, required): 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_files`, true/false): Also delete the movie's folder and files from disk. This can't be undone. Default: `false`.
- Exclude from import lists (`add_exclusion`, true/false): Keep Radarr's import lists from adding it again. Default: `false`.

**Outputs**

- `deleted` (true/false): True: it's out of Radarr
- `excluded` (true/false): Whether it's kept out of import lists
- `files_deleted` (true/false): Whether its files were deleted from disk
- `id` (number): The movie's ID in Radarr, which is gone now
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `year` (number): Its year

**Example output**

```json
{
  "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**

- `count` (number): How many disks Radarr reports
- `disks` (list): Every disk Radarr can see
- `lowest_percent_free` (number): The least free space on any disk, in percent
- `root_folders` (list): The root folders movies go in

**Example output**

```json
{
  "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**

- `errors` (number): How many errors
- `healthy` (true/false): True when Radarr reports no warnings or errors
- `instance_name` (text): Radarr's name, as set under Settings > General
- `issues` (list): What Radarr's health check reports
- `link` (text): A link to Radarr's System > Status page
- `started` (text): When Radarr last started (UTC)
- `version` (text): Radarr's version
- `warnings` (number): How many warnings

**Example output**

```json
{
  "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 (`movie`, text, required): 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**

- `added` (text): When it was added to Radarr (UTC)
- `available` (true/false): Whether it has reached its minimum availability
- `certification` (text): Its rating, such as PG-13
- `digital_release` (text): When it came out digitally (UTC)
- `downloaded` (true/false): Whether Radarr has a file of it
- `file` (object): Its file, when it has one
- `genres` (list): Its genres
- `id` (number): The movie's ID in Radarr, for other Radarr steps
- `imdb_id` (text): Its IMDb ID, such as tt0133093
- `in_cinemas` (text): When it opened in cinemas (UTC)
- `link` (text): A link to it in Radarr
- `minimum_availability` (text): When Radarr starts looking: announced, inCinemas or released
- `monitored` (true/false): Whether Radarr looks for it and its upgrades
- `overview` (text): What it's about
- `path` (text): Its folder on Radarr's server
- `physical_release` (text): When it came out on disc (UTC)
- `poster_url` (text): A link to its poster
- `quality_profile` (text): Its quality profile's name
- `quality_profile_id` (number): Its quality profile's ID
- `rating` (number): Its IMDb rating out of 10 (TMDB's when IMDb has none)
- `root_folder` (text): The root folder it's in
- `runtime_minutes` (number): How long it runs, in minutes
- `size_on_disk` (number): How many bytes its files take
- `status` (text): announced, inCinemas, released, tba or deleted
- `studio` (text): Its studio
- `tags` (list): Its tags' names
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `tmdb_link` (text): A link to it on TMDB
- `year` (number): Its year

**Example output**

```json
{
  "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 (`days`, number): How many days ahead to look. Defaults to 7. From 1 to 365.
- Include unmonitored (`include_unmonitored`, true/false): Also list movies Radarr isn't monitoring. Default: `false`.

**Outputs**

- `count` (number): How many movies have a release then
- `end` (text): To when (UTC)
- `movies` (list): The movies, soonest release first
- `start` (text): From when (UTC)

**Example output**

```json
{
  "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 (`event`, text): 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 (`movie`, text): Only events for this movie.
- Within the last (days) (`days`, number): Only events from the last this many days. From 1 to 3650.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `events` (list): The events, newest first

**Example output**

```json
{
  "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_available`, true/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 (`limit`, number): The most to list. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `monitored_missing` (number): How many monitored movies have no file, released or not
- `movies` (list): The missing movies, by title

**Example output**

```json
{
  "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 (`search`, text): Only movies with these words in the title.
- Downloaded (`downloaded`, text): 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 (`monitored`, text): Only monitored movies, or only those that aren't. One of: `any`, `monitored`, `unmonitored` (Not monitored). Default: `any`.
- Tag (`tag`, text): Only movies with this tag.
- Sort by (`sort`, text): The order to list them in. One of: `title`, `added` (Newest added first), `year` (Newest year first). Default: `title`.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `movies` (list): The movies
- `total` (number): How many match in all

**Example output**

```json
{
  "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_stuck`, true/false): Only downloads that need a person. Default: `false`.
- How many (`limit`, number): The most to list. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `items` (list): The downloads
- `stuck` (number): How many need a person
- `total` (number): How many downloads are in the queue (that match)

**Example output**

```json
{
  "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 (`term`, text, required): A title, such as The Matrix, or tmdb:603, or an IMDb ID such as tt0133093.
- How many (`limit`, number): The most to list. Defaults to 10. From 1 to 50.

**Outputs**

- `count` (number): How many are listed
- `movies` (list): The movies found, best match first
- `term` (text): What was looked up
- `total` (number): How many were found

**Example output**

```json
{
  "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 (`movie`, text): The movie to refresh. Leave blank to refresh every movie, which can take a while.

**Outputs**

- `command` (text): The task, such as Movies Search
- `command_id` (number): Radarr's ID for the task
- `ended` (text): When it finished (UTC)
- `finished` (true/false): Whether it finished while the step waited
- `message` (text): What Radarr said when it finished
- `movie_id` (number): The movie's ID in Radarr; 0 for every movie
- `movie_title` (text): The movie's title; blank for every movie
- `queued` (text): When it was queued (UTC)
- `started` (text): When it started (UTC)
- `status` (text): queued, started or completed

**Example output**

```json
{
  "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 (`item`, text, required): The download: its ID in the queue (from List queue) or its release name.
- Remove from download client (`remove_from_client`, true/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 (`blocklist`, true/false): Never grab this release again, and search for another. Default: `false`.

**Outputs**

- `blocklisted` (true/false): Whether the release was blocklisted
- `id` (number): The download's ID in the queue
- `movie_id` (number): The movie's ID in Radarr
- `movie_title` (text): The movie's title
- `removed` (true/false): True: it's out of the queue
- `removed_from_client` (true/false): Whether it was removed from the download client too
- `title` (text): The release's name

**Example output**

```json
{
  "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 (`movie`, text, required): 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 (`tags`, text, required): Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.

**Outputs**

- `added` (text): When it was added to Radarr (UTC)
- `available` (true/false): Whether it has reached its minimum availability
- `certification` (text): Its rating, such as PG-13
- `changed_tags` (list): The tags added (or removed) by this step
- `digital_release` (text): When it came out digitally (UTC)
- `downloaded` (true/false): Whether Radarr has a file of it
- `file` (object): Its file, when it has one
- `genres` (list): Its genres
- `id` (number): The movie's ID in Radarr, for other Radarr steps
- `imdb_id` (text): Its IMDb ID, such as tt0133093
- `in_cinemas` (text): When it opened in cinemas (UTC)
- `link` (text): A link to it in Radarr
- `minimum_availability` (text): When Radarr starts looking: announced, inCinemas or released
- `monitored` (true/false): Whether Radarr looks for it and its upgrades
- `overview` (text): What it's about
- `path` (text): Its folder on Radarr's server
- `physical_release` (text): When it came out on disc (UTC)
- `poster_url` (text): A link to its poster
- `quality_profile` (text): Its quality profile's name
- `quality_profile_id` (number): Its quality profile's ID
- `rating` (number): Its IMDb rating out of 10 (TMDB's when IMDb has none)
- `root_folder` (text): The root folder it's in
- `runtime_minutes` (number): How long it runs, in minutes
- `size_on_disk` (number): How many bytes its files take
- `status` (text): announced, inCinemas, released, tba or deleted
- `studio` (text): Its studio
- `tags` (list): Its tags' names
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `tmdb_link` (text): A link to it on TMDB
- `year` (number): Its year

**Example output**

```json
{
  "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 (`movie`, text): The movie to search for. Leave blank to search for every monitored movie that's missing.

**Outputs**

- `command` (text): The task, such as Movies Search
- `command_id` (number): Radarr's ID for the task
- `ended` (text): When it finished (UTC)
- `finished` (true/false): Whether it finished while the step waited
- `message` (text): What Radarr said when it finished
- `movie_id` (number): The movie's ID in Radarr; 0 for every movie
- `movie_title` (text): The movie's title; blank for every movie
- `queued` (text): When it was queued (UTC)
- `started` (text): When it started (UTC)
- `status` (text): queued, started or completed

**Example output**

```json
{
  "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 (`movie`, text, required): 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 (`monitored`, true/false): On to have Radarr look for it and its upgrades, off to stop. Leave blank to keep it.
- Quality profile (`quality_profile`, text): A new quality profile, such as Ultra-HD. Leave blank to keep it.
- Minimum availability (`minimum_availability`, text): 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**

- `added` (text): When it was added to Radarr (UTC)
- `available` (true/false): Whether it has reached its minimum availability
- `certification` (text): Its rating, such as PG-13
- `changed` (list): What changed, such as monitored
- `digital_release` (text): When it came out digitally (UTC)
- `downloaded` (true/false): Whether Radarr has a file of it
- `file` (object): Its file, when it has one
- `genres` (list): Its genres
- `id` (number): The movie's ID in Radarr, for other Radarr steps
- `imdb_id` (text): Its IMDb ID, such as tt0133093
- `in_cinemas` (text): When it opened in cinemas (UTC)
- `link` (text): A link to it in Radarr
- `minimum_availability` (text): When Radarr starts looking: announced, inCinemas or released
- `monitored` (true/false): Whether Radarr looks for it and its upgrades
- `overview` (text): What it's about
- `path` (text): Its folder on Radarr's server
- `physical_release` (text): When it came out on disc (UTC)
- `poster_url` (text): A link to its poster
- `quality_profile` (text): Its quality profile's name
- `quality_profile_id` (number): Its quality profile's ID
- `rating` (number): Its IMDb rating out of 10 (TMDB's when IMDb has none)
- `root_folder` (text): The root folder it's in
- `runtime_minutes` (number): How long it runs, in minutes
- `size_on_disk` (number): How many bytes its files take
- `status` (text): announced, inCinemas, released, tba or deleted
- `studio` (text): Its studio
- `tags` (list): Its tags' names
- `title` (text): Its title
- `tmdb_id` (number): Its TMDB ID
- `tmdb_link` (text): A link to it on TMDB
- `year` (number): Its year

**Example output**

```json
{
  "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
}
```
