Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
Task Run

Retrieve all Task Run Targets

List a Task Run's materialized per-Rack execution targets. Each target references the Task the Task Run submitted for that Rack via taskId (null until the target is submitted); drill into execution detail via GET /task/{taskId}.

Filters compose with AND. Results are paginated; the X-Pagination response header reports the total count over the post-filter set.

Task Runs are site-scoped; siteId must be the Site that owns the Task Run. Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

get/v2/org/{org}/nico/task/run/{id}/target

Query parameters

siteIdstring uuid required

ID of the Site that owns the Task Run.

status'Pending' | 'Blocked' | 'Submitted' | 'Completed' | 'Failed' | 'Terminated' | 'Skipped' | 'Claimed'

Filter by target status.

phaseScope'currentPhase' | 'completedPhases' | 'currentAndCompletedPhases'

Restrict targets to the current phase, completed phases, or both.

pageNumberinteger

Page number of results returned (1-indexed).

pageSizeinteger

Number of results per page.

Response

OK

idstring uuid required

Unique identifier of the target.

runIdstring uuid required

ID of the Task Run that owns this target.

rackIdstring uuid required

ID of the Rack this target operates on.

sequenceIndexinteger required

Position of this target in the Task Run's overall processing order.

phaseIndexinteger required

Zero-based index of the phase this target belongs to.

taskIdstring uuid nullable

ID of the Task this target submitted. Null until the target is submitted; drill into execution detail via GET /task/{taskId}.

status'Unknown' | 'Pending' | 'Blocked' | 'Submitted' | 'Completed' | 'Failed' | 'Terminated' | 'Skipped' | 'Claimed' required

Current execution state of the target.

messagestring

Optional human-readable detail for the current target status.

createdstring date-time required

Timestamp when the target was created.

updatedstring date-time required

Timestamp when the target was last updated.