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.
GET
/
assistants
/
{assistant_id}
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/assistants/{assistant_id}",
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}/mithunai/api/v1/assistants/${assistantId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
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",
"updated_at": "2026-09-20T14:03:11.482190"
}
{ "code": "not_found", "message": "The requested resource was not found." }
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.
string
required
The assistant’s ID (UUID).
Response
string
required
The assistant’s ID (UUID).
string
required
Display name.
string
required
Description. Empty string when none was 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 when there is none.boolean
required
true when the assistant is active and has at least one knowledge base.integer
required
Concurrency revision. Send it back on
PATCH /assistants/{assistant_id}.string | null
required
When the assistant was created, ISO 8601 in UTC. Treat a value without an offset as UTC.
string | null
required
When the assistant was last changed, ISO 8601 in UTC. Treat a value without an offset as UTC.
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/assistants/{assistant_id}",
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}/mithunai/api/v1/assistants/${assistantId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
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",
"updated_at": "2026-09-20T14:03:11.482190"
}
{ "code": "not_found", "message": "The requested resource was not found." }
Last modified on September 29, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/assistants/5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
assistant_id = "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13"
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/assistants/{assistant_id}",
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}/mithunai/api/v1/assistants/${assistantId}`,
{
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
},
)
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",
"updated_at": "2026-09-20T14:03:11.482190"
}
{ "code": "not_found", "message": "The requested resource was not found." }