---
title: "List AI Agents (v2, tenant actor)"
method: GET
path: "/v2/apps/{appId}/agents"
tags: ["Agents"]
---

# List AI Agents (v2, tenant actor)

`GET /v2/apps/{appId}/agents`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/agents`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Same operation and query parameters as `GET /v2/agents`.
Supports `User JWT` and `B2B Server JWT`.

Lists the agents whose home App (`ownerAppId`) is the App in the path,
within the usual visibility rules (the caller's own plus public ones).
The caller must manage that App (or belong to it).

## Path parameters

- `appId` string, required

## Query parameters

- `visibility` 'public' | 'mine' | 'all' | 'private'
- `appId` string
- `category` 'customer-support' | 'persona' | 'entertainment' | 'worker'
- `limit` integer
- `offset` integer

## Response `200`

```
{ ok: true, total: number, items: [Agent], results: [Agent], pagination: { total: number } }
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: ``` { error: string, code: 'VALIDATION_ERROR' } ```
- `500`: Internal Server Error

---

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