Create an assistant over your knowledge

curl --request POST "$MITHUNAI_URL/arukz/api/v1/assistants" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Developer docs assistant",
    "knowledge_base_ids": ["a3c7e1f0-2b9d-4c56-8e14-7f0a9b3d6e21"],
    "instruction": "Answer for developers integrating the public API. Prefer code samples.",
    "description": "Answers questions on the developer portal"
  }'

import os, requests

response = requests.post(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={
        "name": "Developer docs assistant",
        "knowledge_base_ids": ["a3c7e1f0-2b9d-4c56-8e14-7f0a9b3d6e21"],
        "instruction": "Answer for developers integrating the public API. Prefer code samples.",
        "description": "Answers questions on the developer portal",
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const response = await fetch(`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Developer docs assistant',
    knowledge_base_ids: ['a3c7e1f0-2b9d-4c56-8e14-7f0a9b3d6e21'],
    instruction: 'Answer for developers integrating the public API. Prefer code samples.',
    description: 'Answers questions on the developer portal',
  }),
})
console.log(await response.json())

{
  "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+00:00",
  "updated_at": "2026-09-20T14:03:11.482190+00:00"
}

{
  "code": "validation_error",
  "message": "A knowledge base named by this assistant does not exist."
}

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "conflict", "message": "An assistant with that name already exists." }