---
title: "List Deployment Workers"
method: GET
path: "/v1/workflows/deployments/{name}/workers"
tags: ["workflows.deployments"]
---

# List Deployment Workers

`GET /v1/workflows/deployments/{name}/workers`

List Deployment Workers

## Path parameters

- `name` string, required

## Query parameters

- `worker_status` 'active' | 'inactive', nullable — Filter by worker activity. active=only active, inactive=only inactive, None=no filter
- `limit` integer — Maximum number of workers to return
- `cursor` string, nullable — Cursor from a previous response's `next_cursor`. Resend `worker_status` unchanged alongside it.

## Response `200`

Successful Response

- DeploymentWorkerListResponse
  - `workers` DeploymentWorkerResponse[], required — Workers registered for the deployment
    - `name` string, required — Worker name
    - `created_at` string, date-time, required — When the worker first registered
    - `updated_at` string, date-time, required — When the worker last registered
    - `is_active` boolean, required — Whether this worker's liveness key is currently alive
    - `location` DeploymentLocation
      - `location_type` 'local' | 'k8s' | 'managed', required
      - `k8s_cluster` string, nullable — K8s cluster name, if applicable
      - `k8s_namespace` string, nullable — K8s namespace, if applicable
  - `next_cursor` string, nullable, required — Cursor for the next page of results

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)