Sign in
Task Run

Create a Task Run

Create a Task Run: a phased, policy-gated execution of one operation across many Racks. The configuration is validated server-side by Flow; on validation failure no state changes.

A Task Run executes exactly one operation over a candidate set of Racks, narrowed by an optional selector and divided into phases by an optional options.phasePolicy. The response echoes the assigned id; the Task Run always starts in the Pending state. Poll GET /task/run/{id} for progress.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

post/v2/org/{org}/nico/task/run

Request body

siteIdstring uuid required

ID of the Site to create the Task Run on.

namestring required

Human-readable name of the Task Run.

descriptionstring

Optional free-form description.

Example request

{
  "options": {
    "conflictPolicy": {
      "retry": {
        "retryTimeout": "30m",
        "initialRetryDelay": "10s",
        "maxRetryDelay": "5m"
      }
    }
  }
}

Response

Task Run was created.

idstring uuid required

Unique identifier of the Task Run.

namestring required

Human-readable name of the Task Run.

descriptionstring

Optional free-form description.

operationType'PowerControl' | 'FirmwareControl' required

Type of operation this Task Run executes. Currently always FirmwareControl.

operationCodestring

Operation code within the operation type (e.g. upgrade).

status'Unknown' | 'Pending' | 'Running' | 'Paused' | 'Completed' | 'Cancelled' | 'Failed' | 'CompletedWithFailures' required

Current lifecycle state of the Task Run.

statusReason'Unknown' | 'None' | 'OperatorPaused' | 'PhaseGate' | 'SafetyGate' | 'ConflictRetryTimeout' required

Why the Task Run is paused or terminal (e.g. PhaseGate, SafetyGate). None when there is no qualifying reason.

statusMessagestring

Optional human-readable detail for the current status.

totalPhasesinteger required

Total number of phases the selected targets were divided into.

createdstring date-time required

Timestamp when the Task Run was created.

updatedstring date-time required

Timestamp when the Task Run was last updated.

startedstring date-time nullable

Timestamp when the Task Run started execution. Null before it starts.

finishedstring date-time nullable

Timestamp when the Task Run reached a terminal state. Null while active.

Changes