Get an assistant with its field limits
The same assistant object plus the field limits the server enforces and the allowed status values, so an editing form validates before it saves, not after.
GET
/
assistants
/
{assistant_id}
/
settings
curl --request GET "$MITHUNAI_URL/arukz/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13/settings" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants/{assistant_id}/settings",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const assistantId = '5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants/${assistantId}/settings`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"assistant": {
"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"
},
"limits": {
"max_name_chars": 120,
"max_description_chars": 500,
"max_instruction_chars": 8000,
"max_knowledge_bases": 20
},
"statuses": ["active", "archived", "disabled"]
}
{ "code": "not_found", "message": "The requested resource was not found." }
Use this to build an assistant settings form. It returns the same assistant object as
GET /assistants/{assistant_id}, plus the field limits the server enforces and the allowed status values, so your form can validate before it saves.
The limits are fixed by the API contract, not by your deployment. An assistant that does not exist, belongs to another organization, or has a malformed ID returns 404. Requires the owner, admin, editor or member role.
string
required
The assistant’s ID (UUID).
Response
object
required
The full assistant.
Show properties
Show properties
string
required
The assistant’s ID (UUID).
string
required
Display name.
string
required
Description. Empty string when none is set.
string
required
active, disabled or archived.string
required
The model selector.
string[]
required
Knowledge bases the assistant answers from.
string | null
required
The stored instruction, or
null.boolean
required
true when the assistant is active and has at least one knowledge base.integer
required
Concurrency revision.
string | null
required
ISO 8601, UTC. Treat a value without an offset as UTC.
string | null
required
ISO 8601, UTC. Treat a value without an offset as UTC.
object
required
string[]
required
Every allowed
status value, sorted: active, archived, disabled.curl --request GET "$MITHUNAI_URL/arukz/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13/settings" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants/{assistant_id}/settings",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const assistantId = '5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants/${assistantId}/settings`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"assistant": {
"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"
},
"limits": {
"max_name_chars": 120,
"max_description_chars": 500,
"max_instruction_chars": 8000,
"max_knowledge_bases": 20
},
"statuses": ["active", "archived", "disabled"]
}
{ "code": "not_found", "message": "The requested resource was not found." }
Last modified on September 26, 2026
⌘I
curl --request GET "$MITHUNAI_URL/arukz/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13/settings" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/assistants/{assistant_id}/settings",
headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
print(response.json())
const assistantId = '5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13'
const response = await fetch(
`${process.env.MITHUNAI_URL}/arukz/api/v1/assistants/${assistantId}/settings`,
{ headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
)
console.log(await response.json())
{
"assistant": {
"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"
},
"limits": {
"max_name_chars": 120,
"max_description_chars": 500,
"max_instruction_chars": 8000,
"max_knowledge_bases": 20
},
"statuses": ["active", "archived", "disabled"]
}
{ "code": "not_found", "message": "The requested resource was not found." }