> 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: "List workers"
description: "List workers. Scope the query with either project_id or deployment_id."
method: "GET"
endpoint: "/api/v1/workers"
order: 1
last_verified: 2026-07-27
---



`GET /api/v1/workers`

List workers. Scope the query with either project_id or deployment_id.


  ### Query parameters

  - `project_id` _string_ — List every worker across a project's deployments. Required unless deployment_id is set.
  - `deployment_id` _string_ — List workers for a single deployment. Required unless project_id is set.
  - `worker_type` _string_ — Filter by type: application, dev, eval, or ai.



  ### Request example


```bash
curl "https://api.agnt5.com/api/v1/workers?deployment_id=8a1c2d3e-9c4d-4f7a-8e2b-1a2b3c4d5e6f" \
  -H "X-API-KEY: {api_key}"
```

```javascript
fetch('https://api.agnt5.com/api/v1/workers?deployment_id=' + deploymentId, {
  headers: { 'X-API-KEY': apiKey }
})
```


  ```json {{ title: 'Response' }}
  {
    "success": true,
    "message": "Workers retrieved successfully",
    "data": [
      {
        "id": "f5a6b7c8-...",
        "worker_name": "invoice-processor-worker-7d9f",
        "worker_version": "1.4.2",
        "worker_type": "application",
        "deployment_id": "8a1c2d3e-...",
        "hostname": "invoice-processor-7d9f-x8k2",
        "ip_address": "10.2.4.18",
        "port": 8080,
        "status": "connected",
        "health_status": "healthy",
        "last_heartbeat": 1753612920000,
        "heartbeat_interval": 5000,
        "max_concurrent_tasks": 20,
        "current_task_count": 3
      }
    ]
  }
  ```