---
title: "Get Custom Agents"
method: GET
path: "/agent/custom/list"
---

# Get Custom Agents

`GET /agent/custom/list`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/agent/custom/list`
- Auth: none declared

## Query parameters

- `with_public_access` boolean
- `right` 'ADMIN' | 'READ' | 'WRITE' | 'VIEW': A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN. On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.
- `offset` integer
- `limit` integer

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- APICustomAgentWithoutData[]
  - `id` string, required
  - `name` string, required
  - `description` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_edit` string, date-time, nullable
  - `logo_url` string, nullable, required
  - `logo_mime_type` string, nullable
  - `logo_status` 'PROCESSING' | 'READY' | 'OPTIMIZED' | 'FAILED'
  - `demo_url` string, nullable
  - `demo_mime_type` string, nullable
  - `is_public_read` boolean
  - `publication_status` 'ORIGINAL' | 'PENDING' | 'POSTED': Where a ``ta_custom_agent`` row sits in the publication flow. An assistant is ORIGINAL and stays editable for its whole life. Publishing freezes a copy of it as PENDING; approving that copy makes it POSTED and retires whichever copy was POSTED before. An assistant can therefore have a live copy and a copy under review at the same time — which is the point, since otherwise submitting an update would mean taking the live one down.
  - `needs_changes` boolean
  - `slug_id` string, nullable
  - `created_from_custom_agent_id` string, nullable
  - `pending_custom_agent_id` string, nullable
  - `pending_needs_changes` boolean, nullable
  - `pending_reviewer_comment` string, nullable
  - `posted_custom_agent_id` string, nullable
  - `labels` string[]
  - `likes_count` integer
  - `dislikes_count` integer
  - `my_vote` boolean, nullable
  - `review` APICustomAgentReview
    - `status` 'REVIEW_PENDING' | 'REVIEW_APPROVED' | 'REVIEW_CHANGE_REQUESTED', required
    - `reviewer_comment` string, nullable
    - `requested_at` string, date-time, nullable
    - `reviewed_at` string, date-time, nullable
  - `role` CustomAgentRole[]
  - `is_owner` boolean, nullable
  - `author_email` string, nullable

## Other responses

- `422`: Validation Error

---

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