> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List the assistants in your organisation

> List assistants as summaries, most recently updated first. A summary carries no instruction and a knowledge-base count rather than ids; archived ones omitted.

Returns **summaries**, not full assistants. A summary has no `instruction` and reports `knowledge_base_count` instead of the list of IDs. Use `GET /assistants/{assistant_id}` for the full configuration.

Archived assistants are left out unless you ask for them with `status=archived`. The list is not paginated: `limit` caps the number of results and there is no cursor.

There is no delete route for assistants. To retire one, set its `status` to `archived` with `PATCH /assistants/{assistant_id}`.

Listing assistants requires the owner, admin, editor or member role.

<ParamField query="status" type="string">
  Return only assistants with this status: `active`, `disabled` or `archived`. Any other value
  returns `400`. When omitted, every status except `archived` is returned.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Maximum number of assistants to return, from 1 to 100. A value outside that range, or one that is
  not a whole number, returns `400`.
</ParamField>

## Response

<ResponseField name="data" type="object[]" required>
  Assistant summaries, ordered by `updated_at`, newest first.

  <Expandable title="properties">
    <ResponseField name="id" type="string" required>
      The assistant's ID (UUID).
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Display name.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Description. Empty string when none was set.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      `active`, `disabled` or `archived`.
    </ResponseField>

    <ResponseField name="model" type="string" required>
      The model selector.
    </ResponseField>

    <ResponseField name="knowledge_base_count" type="integer" required>
      How many knowledge bases the assistant answers from.
    </ResponseField>

    <ResponseField name="updated_at" type="string | null" required>
      When the assistant was last changed, ISO 8601 in UTC. Treat a value without an offset as UTC.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request GET "$MITHUNAI_URL/arukz/api/v1/assistants?status=active&limit=20" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      params={"status": "active", "limit": 20},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const params = new URLSearchParams({ status: 'active', limit: '20' })
  const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants?${params}`, {
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  })
  console.log(await response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": [
      {
        "id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
        "name": "Developer docs assistant",
        "description": "Answers questions on the developer portal",
        "status": "active",
        "model": "anthropic/claude-sonnet-5",
        "knowledge_base_count": 1,
        "updated_at": "2026-09-20T14:03:11.482190"
      },
      {
        "id": "c84d2f61-0a3e-4b7c-9e25-6f1b8d4a7c90",
        "name": "Support assistant",
        "description": "",
        "status": "active",
        "model": "anthropic/claude-sonnet-5",
        "knowledge_base_count": 3,
        "updated_at": "2026-09-18T09:41:27.105332"
      }
    ]
  }
  ```

  ```json 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "validation_error", "message": "'status' is not a recognised value." }
  ```
</ResponseExample>