Unraid icon

Unraid

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

Array → Start

AI-generated

Summary

Starts the Unraid array by sending a GraphQL setState mutation with desiredState START, and returns the resulting array id and state.

Inputs

  • Maximum Control Level — Caps what this node may do: Use Credential Default (inherit), Read, Control, or Full. It can only narrow the credential's limit, never raise it. Starting the array is a 'control'-risk operation, so the effective level (the lower of this setting and the credential's level) must be Control or Full. Otherwise the node errors before contacting the server.

Output shape

One item per input item, with the setState result as JSON: the array's id and state as reported by Unraid after the mutation.

The call is not polled, so the returned state may be a transitional value rather than a fully started array. If the effective control level is Read, the node throws a permission error. With Continue On Fail enabled, errors are returned as an item with an error message. The credential's maxControlLevel defaults to 'read' if unset, so it must be raised for this to work.

Examples

Example 1: Start the array after a scheduled maintenance window or reboot.

Resource: Array, Operation: Start, Maximum Control Level: Use Credential Default (credential must be Control or Full).

Example 2: Expose array start to an AI Agent without allowing destructive actions.

Resource: Array, Operation: Start, Maximum Control Level: Control, so Stop Array stays blocked.

Links

Discussion