> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/infra-controller/_mcp/server.

# Task Run

A Task Run is a phased, policy-gated execution of one operation across many Racks. A Task Run narrows a candidate set of Racks with an optional selector, divides the selected Racks into phases, and drives one execution target per Rack; each target in turn drives at most one Task. Safety gates pause the Task Run when failures exceed a threshold, and phase gates hold each phase until an operator advances it. This tag exposes creation, retrieval, target listing, and the pause / resume / advance / cancel lifecycle actions; drill into per-Rack execution detail via the Task tag using each target's `taskId`.


## API Docs

- Task Run [Retrieve all Task Runs](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/get-all-task-run.md)
- Task Run [Create a Task Run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/create-task-run.md)
- Task Run [Retrieve a Task Run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/get-task-run.md)
- Task Run [Retrieve all Task Run Targets](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/get-all-task-run-target.md)
- Task Run [Pause a Task Run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/pause-task-run.md)
- Task Run [Resume a Task Run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/resume-task-run.md)
- Task Run [Advance a Task Run to its next phase](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/advance-task-run.md)
- Task Run [Cancel a Task Run](https://docs.nvidia.com/infra-controller/rest-api-reference/api-reference/task-run/cancel-task-run.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.nvidia.com/infra-controller/openapi.json)
- [OpenAPI YAML](https://docs.nvidia.com/infra-controller/openapi.yaml)