> ## 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.

# Get an assistant and its instruction

> Retrieve one assistant's full configuration, its instruction included. Archived ones are still returned; there is no delete route, so retire one by status.

An assistant that does not exist, belongs to another organization, or has a malformed ID all return the same `404`. Archived assistants are still returned.

Reading an assistant requires the owner, admin, editor or member role. There is no delete route; retire an assistant by setting its `status` to `archived`.

<ParamField path="assistant_id" type="string" required>
  The assistant's ID (UUID).
</ParamField>

## Response

<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_ids" type="string[]" required>
  Knowledge bases the assistant answers from.
</ResponseField>

<ResponseField name="instruction" type="string | null" required>
  The stored instruction, or `null` when there is none.
</ResponseField>

<ResponseField name="answerable" type="boolean" required>
  `true` when the assistant is `active` and has at least one knowledge base.
</ResponseField>

<ResponseField name="revision" type="integer" required>
  Concurrency revision. Send it back on `PATCH /assistants/{assistant_id}`.
</ResponseField>

<ResponseField name="created_at" type="string | null" required>
  When the assistant was created, ISO 8601 in UTC. Treat a value without an offset as UTC.
</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>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request GET "$MITHUNAI_URL/arukz/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

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

  assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants/{assistant_id}",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const assistantId = '5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13'
  const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants/${assistantId}`, {
    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"}}
  {
    "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_ids": ["a3c7e1f0-2b9d-4c56-8e14-7f0a9b3d6e21"],
    "instruction": "Answer for developers integrating the public API. Prefer code samples.",
    "answerable": true,
    "revision": 1,
    "created_at": "2026-09-20T14:03:11.482190",
    "updated_at": "2026-09-20T14:03:11.482190"
  }
  ```

  ```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "not_found", "message": "The requested resource was not found." }
  ```
</ResponseExample>