---
title: "List Agents"
method: GET
path: "/api/v1/workspaces/{workspace_id}/agents"
tags: ["agents"]
---

# List Agents

`GET /api/v1/workspaces/{workspace_id}/agents`

## Path parameters

- `workspace_id` string, required

## Headers

- `authorization` string, required

## Response `200`

Successful Response

- AgentListResponse
  - `agents` AgentDefinitionResponse[], required
    - `id` string, required
    - `workspace_id` string, required
    - `agent_role` string, required
    - `agent_mesh_id` string, required
    - `capabilities` string, required
    - `initial_balance` number, required
    - `is_active` boolean, required
    - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tomeku-development/apis/mesh-platform-api.md) · [All operations](https://skmtc.dev/tomeku-development/apis/mesh-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tomeku-development/mesh-platform-api/revisions/08ace1bb7b09/schema)