Errors & task states reference

The states a background task moves through, VM power states, and the responses you may see when something is rejected.

Background task states

State-changing operations run asynchronously: the API queues a task and workers carry it out. Track progress in the Task Manager (top bar).

Status	Meaning
pending	Queued, not yet picked up by a worker
processing	A worker is actively carrying out the operation (progress 0–100%)
completed	The operation finished successfully
failed	The operation did not complete; the resource is left in its prior state
cancelled	The operation was cancelled before completion

A task left in processing past the timeout (about 10 minutes) is automatically returned to pending for retry.

State	Meaning
running	Powered on
stopped	Powered off
initializing	Being created / provisioned
restarting	A start or restart is in progress
stopping	A stop is in progress
hibernating	A shutdown is in progress
terminating	A delete is in progress
terminated	Deleted (soft-deleted)

A VM can be deleted only while it is stopped or initializing.

Code	When it happens	What to do
400	Invalid input — a field failed validation or the request body was malformed	Correct the highlighted field(s) and resubmit
401	Your session expired	Sign in again; the app attempts a silent refresh first
403	Insufficient permissions for the action	Ask an administrator for the required permission — see Permissions reference (click here)
409	A conflicting record already exists (e.g. that name or email is taken)	Choose a different, unique value
503	Could not acquire the operation lock	Wait a moment and retry — another operation was in flight

Navigating to a page you lack permission for redirects you to an Unauthorized screen.
Sidebar items you cannot use are hidden rather than shown disabled.
The entire Platform section is hidden for non-root accounts.

Lower costs. Simplify operations. Deliver more.