Import a finished download
import_downloadImports a finished download the *arr left stuck at importBlocked: preview files to import or skip, fix wrong matches with mapping, rerun post-processing, or remap episodes before confirming.
Instructions
Gets a finished download into the library when the *arr never took it: one stuck at importBlocked in get_queue, by its download_id; mapping fixes a wrong match. Previews the files it will import and skip, and never forces one the service refuses. postprocess first reruns NZBGet's post-processing, for a download a broken script left unimportable. remap says which episode an imported file really is. On Grimmory, id is a Bookdrop file from get_queue. Rescan or rename: trigger_scan. An import queues and returns (get_stack_health commands). Previews first; confirm to run. Field reference: arr://docs/import_download.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"service": "<service>"
},
"name": "import_download"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | For remap, the Sonarr series: `acquisition.id` on a get_library record. On grimmory, the Bookdrop file to import, from get_queue. | |
| action | No | import (default): a finished download, by `download_id`. postprocess (NZBGet): reruns its post-processing, by `download_id`. remap (Sonarr): moves imported files to the episodes they really are, with `id` and `reassignments`. | import |
| confirm | No | The token from this tool's preview; pass it back to apply. | |
| dry_run | No | Preview only, no token issued: for "what if" questions, not the first step of a change. | |
| library | No | Grimmory only: the library to import the Bookdrop file into, by name or id. Omit when there is one. | |
| mapping | No | What each file is. The service judges each mapped file again and imports it only if it accepts it; unmapped files keep its own match. | |
| service | Yes | ||
| instance | No | Which instance (e.g. "4k") when several of this service exist. Omit it when there is one. | |
| download_id | No | `downloadId` on the get_queue row (nzbget: or its get_history row). | |
| reassignments | No | Include every file the change touches: a file moved onto an episode that already has one must say where that one goes too, or the call is refused. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| noop | Yes | ||
| tier | Yes | ||
| tool | Yes | ||
| target | Yes | ||
| applied | Yes | ||
| dry_run | Yes | ||
| effects | Yes | ||
| service | Yes | ||
| summary | Yes | ||
| operation | Yes | ||
| permission | Yes |