---
title: "get workergroup workers"
method: POST
path: "/get_workergroup_workers/"
tags: ["Serverless"]
---

# get workergroup workers

`POST /get_workergroup_workers/`

Retrieves the current list and status of workers for a specific workergroup.
Useful for monitoring, debugging connectivity issues, and understanding resource usage within a workergroup.

CLI Usage: `vastai get workergroup workers <id>`

## Request body

- object
  - `id` integer, required — ID of the workergroup to monitor

## Response `200`

Workers successfully retrieved.

- union
  - object
    - `workers` object[] — List of workers in this workergroup
      - `id` integer — Workergroup instance ID
      - `status` string — Current worker status
      - `url` string — Worker instance URL
      - `created_at` string — When the worker was created
  - string — Error message when workergroup not found or authentication fails

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/versions/4ed14f79f796/schema)