---
title: "Read Agent Directory"
method: GET
path: "/api/v1/agents/directory"
tags: ["agents"]
---

# Read Agent Directory

`GET /api/v1/agents/directory`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/agents/directory`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Lean, alphabetical agent rows for pickers (id, name, uri, avatar, access, accent).

## Query parameters

- `skip` integer
- `limit` integer
- `search` string, nullable

## Response `200`

Successful Response

- PaginatedResponseAgentDirectoryItem
  - `data` AgentDirectoryItem[], required
    - `id` integer, required
    - `name` string, required
    - `uri` string, nullable
    - `image_url` string, nullable
    - `access_level` 'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
    - `updated_at` string, date-time, nullable
    - `accent_preset` string, nullable
  - `pagination` PaginationMeta, required
    - `total` integer, required
    - `skip` integer, required
    - `limit` integer, required
    - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

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