---
title: "List all workloads"
method: GET
path: "/api/v1beta/workloads"
tags: ["workloads"]
---

# List all workloads

`GET /api/v1beta/workloads`

Get a list of all running workloads, optionally filtered by group

## Query parameters

- `all` boolean
- `group` string

## Response `200`

OK

- PkgApiV1WorkloadListResponse — Response containing a list of workloads
  - `workloads` CoreWorkload[] — List of container information for each workload
    - `created_at` string — CreatedAt is the timestamp when the workload was created.
    - `group` string — Group is the name of the group this workload belongs to, if any.
    - `labels` object — Labels are the container labels (excluding standard ToolHive labels)
    - `name` string — Name is the name of the workload. It is used as a unique identifier.
    - `package` string — Package specifies the Workload Package used to create this Workload.
    - `port` integer — Port is the port on which the workload is exposed. This is embedded in the URL.
    - `proxy_mode` string — ProxyMode is the proxy mode that clients should use to connect. For stdio transports, this will be the proxy mode (sse or streamable-http). For direct transports (sse/streamable-http), this will be the same as TransportType.
    - `remote` boolean — Remote indicates whether this is a remote workload (true) or a container workload (false).
    - `started_at` string — StartedAt is when the container was last started (changes on restart)
    - `status` 'running' | 'stopped' | 'error' | 'starting' | 'stopping' | 'unhealthy' | 'removing' | 'unknown' | 'unauthenticated' | 'auth_retrying' | 'policy_stopped' — Status is the current status of the workload.
    - `status_context` string — StatusContext provides additional context about the workload's status. The exact meaning is determined by the status and the underlying runtime.
    - `tools` string[] — ToolsFilter is the filter on tools applied to the workload.
    - `transport_type` 'stdio' | 'sse' | 'streamable-http' | 'inspector' — TransportType is the type of transport used for this workload.
    - `url` string — URL is the URL of the workload exposed by the ToolHive proxy.

## Other responses

- `404` — Group not found

---

[API](https://skmtc.dev/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.dev/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/revisions/e9f942effcda/schema)