> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Workers"
description: "List and inspect the worker processes that execute your deployed workflows, agents, and functions."
last_verified: 2026-07-27
---


**Endpoints**: `GET /api/v1/workers`, `GET /api/v1/workers/:id`
**Auth**: `X-API-KEY` or `Authorization: Bearer <token>` (required)
**Error envelope**: 4xx/5xx return `{"error": string, "message": string, "code": int, "hint"?: string}`


A **worker** is a running process that connects to AGNT5 and executes the functions, workflows, and agents registered in your code. Workers belong to a [deployment](/docs/api-reference/deployments.md).

## Next steps

* [Deployments](/docs/api-reference/deployments.md): list the workers attached to a specific deployment
* [Runs & Traces](/docs/api-reference/runs-and-traces.md): see what a worker actually executed
* [CLI status](/cli/commands.md#agnt5-status): watch worker health live with **`agnt5 status`**