---
title: "List Task"
method: GET
path: "/api/task"
tags: ["Workflow API"]
---

# List Task

`GET /api/task`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `workflow_id` string, nullable
- `statuses` TaskGroupStatus[], nullable
- `users` string[], nullable
- `all_users` boolean
- `pools` string[], nullable
- `all_pools` boolean
- `nodes` string[], nullable
- `started_after` string, date-time, nullable
- `started_before` string, date-time, nullable
- `offset` integer
- `limit` integer
- `order` 'ASC' | 'DESC': Represents the list order for the database.
- `summary` boolean
- `aggregate_by_workflow` boolean
- `priority` WorkflowPriority[], nullable

## Headers

- `x-osmo-user` string, nullable

## Response `200`

Successful Response

- union
  - ListTaskSummaryResponse
    - `summaries` ListTaskSummaryEntry[], required
      - `user` string, required
      - `pool` string, nullable
      - `storage` number, required
      - `cpu` integer, required
      - `memory` number, required
      - `gpu` integer, required
      - `priority` string, required
  - ListTaskResponse
    - `tasks` ListTaskEntry[], required
      - `user` string, required
      - `workflow_id` string, required
      - `workflow_uuid` string, required
      - `task_name` string, required
      - `retry_id` integer, required
      - `pool` string, nullable
      - `node` string, nullable
      - `start_time` string, date-time, nullable
      - `end_time` string, date-time, nullable
      - `duration` number, nullable
      - `status` 'SUBMITTING' | 'WAITING' | 'PROCESSING' | 'SCHEDULING' | 'INITIALIZING' | 'RUNNING' | 'COMPLETED' | 'RESCHEDULED' | 'FAILED' | 'FAILED_CANCELED' | 'FAILED_SERVER_ERROR' | 'FAILED_BACKEND_ERROR' | 'FAILED_EXEC_TIMEOUT' | 'FAILED_QUEUE_TIMEOUT' | 'FAILED_IMAGE_PULL' | 'FAILED_UPSTREAM' | 'FAILED_EVICTED' | 'FAILED_START_ERROR' | 'FAILED_START_TIMEOUT' | 'FAILED_PREEMPTED', required: Represents the status of a task group
      - `overview` string, required
      - `logs` string, required
      - `error_logs` string, nullable
      - `grafana_url` string, nullable
      - `dashboard_url` string, nullable
      - `storage` number, required
      - `cpu` integer, required
      - `memory` number, required
      - `gpu` integer, required
      - `priority` string, required
  - ListTaskAggregatedResponse
    - `summaries` ListTaskAggregatedEntry[], required
      - `user` string, required
      - `pool` string, nullable
      - `storage` number, required
      - `cpu` integer, required
      - `memory` number, required
      - `gpu` integer, required
      - `priority` string, required
      - `workflow_id` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 18 breaking, 21 info
  - the `query` request parameter `order` was restricted to a list of enum values
  - response property `anyOf[subschema #1: ListTaskSummaryResponse]/summaries/items/pool` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `anyOf[subschema #2: ListTaskResponse]/tasks/items/dashboard_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `anyOf[subschema #2: ListTaskResponse]/tasks/items/duration` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …35 more
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 1 info
  - the response's body type changed from `string` to no type for status `200`
  - added `#/components/schemas/ListTaskSummaryResponse, #/components/schemas/ListTaskResponse, #/components/schemas/ListTaskAggregatedResponse` to the response body `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/task/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)