---
title: "List assistants (cursor-paginated)"
method: GET
path: "/v1/assistants"
tags: ["assistants"]
---

# List assistants (cursor-paginated)

`GET /v1/assistants`

List assistants with cursor pagination. Archived excluded by default.

## Query parameters

- `limit` integer — Page size; values above 200 are capped at 200.
- `cursor` string, nullable
- `include_archived` boolean
- `search` string, nullable — Search by name or description

## Response `200`

Successful Response

- AssistantListResponse — GET /assistants — cursor-paginated list (§10.1).
  - `assistants` AssistantSummary[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `active_revision_id` string, uuid, nullable
    - `active_revision_name` string, nullable
    - `archived_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/9cd7291d4228/schema)