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

# List Workflow

`GET /api/workflow`

## Request

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

## Query parameters

- `users` string[], nullable
- `name` string, nullable
- `statuses` WorkflowStatus[], nullable
- `offset` integer
- `limit` integer
- `order` 'ASC' | 'DESC': Represents the list order for the database.
- `all_users` boolean
- `pools` string[], nullable
- `all_pools` boolean
- `submitted_before` string, date-time, nullable
- `submitted_after` string, date-time, nullable
- `tags` string[], nullable
- `app` string, nullable
- `priority` WorkflowPriority[], nullable
- `label` string[], nullable: Workflow label selector: key=value with optional * wildcards and (a|b) alternatives, for example key=(team_*|osmo_*) or key=team_(a|b). Repeat for AND semantics.
- `no_label` string[], nullable: Label key that must be absent from the workflow; workflows without any labels match. Repeat for AND semantics.

## Headers

- `x-osmo-user` string, nullable

## Response `200`

Successful Response

- SrcServiceCoreWorkflowObjectsListResponse
  - `workflows` SrcServiceCoreWorkflowObjectsListEntry[], required
    - `user` string, required
    - `name` string, required
    - `workflow_uuid` string, required
    - `submit_time` string, date-time, required
    - `start_time` string, date-time, nullable
    - `end_time` string, date-time, nullable
    - `queued_time` number, required
    - `duration` number, nullable
    - `status` 'PENDING' | 'RUNNING' | 'WAITING' | 'COMPLETED' | 'FAILED' | 'FAILED_SUBMISSION' | 'FAILED_SERVER_ERROR' | 'FAILED_EXEC_TIMEOUT' | 'FAILED_QUEUE_TIMEOUT' | 'FAILED_CANCELED' | 'FAILED_BACKEND_ERROR' | 'FAILED_IMAGE_PULL' | 'FAILED_EVICTED' | 'FAILED_START_ERROR' | 'FAILED_START_TIMEOUT' | 'FAILED_PREEMPTED', required: Represents the status of a workflow.
    - `overview` string, required
    - `logs` string, required
    - `error_logs` string, nullable
    - `grafana_url` string, nullable
    - `dashboard_url` string, nullable
    - `pool` string, nullable
    - `app_owner` string, nullable
    - `app_name` string, nullable
    - `app_version` integer, nullable
    - `priority` string, required
    - `labels` object
  - `more_entries` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 5 info
  - added the new optional `query` request parameter `label`
  - added the new optional `query` request parameter `no_label`
  - 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
  - …1 more
- **2026-04-08** `a8157dc3279d`: 12 breaking, 23 info
  - the `query` request parameter `order` was restricted to a list of enum values
  - response property `workflows/items/app_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `workflows/items/app_owner` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `workflows/items/app_version` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …31 more
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 2 info
  - the response's body type changed from `string` to `object` for status `200`
  - added the required property `more_entries` to the response with the `200` status
  - added the required property `workflows` to the response with the `200` status

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/workflow/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)