---
title: "Get workload status"
method: GET
path: "/api/v1beta/workloads/{name}/status"
tags: ["workloads"]
---

# Get workload status

`GET /api/v1beta/workloads/{name}/status`

Get the current status of a specific workload

## Path parameters

- `name` string, required

## Response `200`

OK

- PkgApiV1WorkloadStatusResponse — Response containing workload status information
  - `status` 'running' | 'stopped' | 'error' | 'starting' | 'stopping' | 'unhealthy' | 'removing' | 'unknown' | 'unauthenticated' | 'auth_retrying' | 'policy_stopped' — Current status of the workload

## Other responses

- `404` — Not Found

## Changes

- **2026-06-25** `3264ef650b69` — 3 warning
  - added the new `auth_retrying` enum value to the `status` response property for the response status `200`
  - added the new `auth_retrying` enum value to the `status` response property for the response status `200`
  - added the new `auth_retrying` enum value to the `status` response property for the response status `200`
- **2026-04-21** `ead8d06eaeaa` — 3 warning
  - added the new `policy_stopped` enum value to the `status` response property for the response status `200`
  - added the new `policy_stopped` enum value to the `status` response property for the response status `200`
  - added the new `policy_stopped` enum value to the `status` response property for the response status `200`
- **2026-01-29** `ff6ce8dd8f3a` — 6 info
  - removed the `auth_retrying` enum value from the `status` response property for the response status `200`
  - removed the `auth_retrying` enum value from the `status` response property for the response status `200`
  - removed the `auth_retrying` enum value from the `status` response property for the response status `200`
  - removed the `policy_stopped` enum value from the `status` response property for the response status `200`
  - …2 more

[Change history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/workloads/:name/status/get.md)

---

[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)