Unraid icon

Unraid

Interact with the Unraid API — manage Docker containers, VMs, array health, disks, notifications, and system metrics

Actions36

Docker → Pause

AI-generated

Summary

Pauses a running Docker container on an Unraid server via the Unraid GraphQL API and returns the container's resulting state. Requires at least the "Control" level.

Inputs

  • Container ID (required) — Prefixed container ID (e.g. docker:abc123). Use Docker > Get Many to find IDs. The source also falls back to matching a short ID prefix (12+ chars), bare ID, or container name when verifying state after a failed re-fetch.
  • Maximum Control Level — Caps what this node may do: Use Credential Default (default), Read, Control, or Full. It can only narrow the credential's limit, never exceed it. Pause is classed as 'control', so Read blocks it with an error before any request is sent.

Output shape

One item per input item, containing the container record from the pause mutation: id, names, state, and status.

Unraid's mutation can error with 'not found after…' even when it succeeds. In that case the node re-lists containers and checks the container is no longer RUNNING. If it is still running, it throws an error. If the container isn't found, or the re-list can't be matched, the fallback result is the listed container or {id, operation:'pause', success:true, state}. With Continue On Fail enabled, errors are returned as {error: message} items.

Examples

Example 1: Pause a specific container during a maintenance window

Resource: Docker, Operation: Pause, Container ID: docker:abc123def456; credential control level at least Control.

Example 2: Let an AI Agent pause containers but not do anything destructive

Use as an agent tool with Maximum Control Level set to Control, and the Container ID supplied by the agent or an expression.

Links

Discussion