---
title: "POST /v2/ListWorkers"
method: POST
path: "/v2/ListWorkers"
tags: ["Worker"]
---

# POST /v2/ListWorkers

`POST /v2/ListWorkers`

List background workers currently running on one or several cluster nodes.

## Query parameters

- `node` string, required

## Request body

- LocalListWorkersRequest
  - `busyOnly` boolean
  - `errorOnly` boolean

## Response `200`

Responses from individual cluster nodes

- MultiResponseLocalListWorkersResponse
  - `error` object, required — Map of node id to error message, for nodes that were unable to complete the API call
  - `success` object, required — Map of node id to response returned by this node, for nodes that were able to successfully complete the API call

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.dev/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/revisions/07ffb2d0febb/schema)