---
title: "List Agents"
method: GET
path: "/agents"
tags: ["Agents"]
---

# List Agents

`GET /agents`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/agents`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer
- `workspace_id` string: Opaque identifier; clients must not parse its format.
- `status` 'draft' | 'inactive' | 'active' | 'paused'
- `q` string

## Response `200`

Accessible Agent summaries

- AgentPage
  - `data` AgentSummary[], required
    - `id` string, required: Opaque identifier; clients must not parse its format.
    - `object` 'agent', required
    - `name` string, required
    - `description` string, required
    - `lifecycle` string, required
    - `organization_id` string, required: Opaque identifier; clients must not parse its format.
    - `workspace_id` string: Opaque identifier; clients must not parse its format.
  - `page` object, required
    - `next_cursor` string, nullable
    - `has_more` boolean, required

## Other responses

- `default`: RFC 9457 problem response

---

[API](https://skmtc.dev/zeronoise/apis/zeronoise-api.md) · [All operations](https://skmtc.dev/zeronoise/apis/zeronoise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeronoise/apis/zeronoise-api/revisions/f7d813d9631d?raw)