Retrieve all Task Run Targets

GET

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/task/run/:id/target

GET

/v2/org/:org/nico/task/run/:id/target

curl -G https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/task/run/id/target \
     -H "Authorization: Bearer <token>" \
     -d siteId=siteId

[
  {
    "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
    "runId": "7a4c1e88-3d21-4f9b-b0c5-2e6d9f1a4b73",
    "rackId": "0eadc9d8-d4ed-41ed-b687-0812d801dad8",
    "sequenceIndex": 0,
    "phaseIndex": 0,
    "status": "Completed",
    "created": "2026-08-10T14:02:44Z",
    "updated": "2026-08-10T14:39:02Z",
    "taskId": "9b8a7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d"
  },
  {
    "id": "d2e3f4a5-6b7c-4d8e-9f0a-1b2c3d4e5f60",
    "runId": "7a4c1e88-3d21-4f9b-b0c5-2e6d9f1a4b73",
    "rackId": "4f7c2b19-8e3d-4a5f-9c1b-6d8e0a2f4b71",
    "sequenceIndex": 1,
    "phaseIndex": 0,
    "status": "Failed",
    "created": "2026-08-10T14:02:44Z",
    "updated": "2026-08-10T15:47:03Z",
    "taskId": "a7b6c5d4-3e2f-4a1b-8c9d-0e1f2a3b4c5e",
    "message": "Task failed: BMC did not report the target version."
  },
  {
    "id": "e3f4a5b6-7c8d-4e9f-0a1b-2c3d4e5f6071",
    "runId": "7a4c1e88-3d21-4f9b-b0c5-2e6d9f1a4b73",
    "rackId": "5a8d3c2b-9f4e-4b6a-8d1c-7e9f0b3a5c82",
    "sequenceIndex": 2,
    "phaseIndex": 1,
    "status": "Pending",
    "created": "2026-08-10T14:02:44Z",
    "updated": "2026-08-10T14:02:44Z",
    "taskId": null
  }
]

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.

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.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

idstringRequiredformat: "uuid"

UUID of the Task Run

Query parameters

siteIdstringRequiredformat: "uuid"

ID of the Site that owns the Task Run.

statusenumOptional

Filter by target status.

phaseScopeenumOptionalDefaults to currentPhase

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

Allowed values:

pageNumberintegerOptional1-21474836

Page number of results returned (1-indexed).

pageSizeintegerOptional1-100

Number of results per page.

Response headers

Response

idstringformat: "uuid"

Unique identifier of the target.

runIdstringformat: "uuid"

ID of the Task Run that owns this target.

rackIdstring

ID of the Rack this target operates on.

sequenceIndexinteger

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

phaseIndexinteger

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

statusenum

Current execution state of the target.

createddatetime

Timestamp when the target was created.

updateddatetime

Timestamp when the target was last updated.

taskIdstring or nullOptionalformat: "uuid"

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

messagestringOptional

Optional human-readable detail for the current target status.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

504

Gateway Timeout Error