---
title: "List assistants"
method: GET
path: "/v1/assistants"
---

# List assistants

`GET /v1/assistants`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/assistants`
- Auth: HTTP bearer

Retrieve a list of agents (apps) accessible to the authenticated organization. Optionally filter by name with case-insensitive search.

## Query parameters

- `name` string: Filter assistants by name (case-insensitive partial match)

## Response `200`

Default Response

- AssistantsList
  - `assistants` Assistant[], required: Array of assistant objects matching the request criteria
    - `id` string, uuid, required: Unique identifier for the assistant
    - `name` string, required: Name of the assistant
    - `createdAt` string, required: ISO 8601 timestamp when the assistant was created

---

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