List the assistants in your organisation
List assistants as summaries, most recently updated first, archived ones omitted. A summary carries no instruction and only a knowledge count.
GET
/
assistants
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/assistants?status=active&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/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())
const params = new URLSearchParams({ status: 'active', limit: '20' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/assistants?${params}`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"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"
}
]
}
{ "code": "validation_error", "message": "'status' is not a recognised value." }
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.
string
Return only assistants with this status:
active, disabled or archived. Any other value
returns 400. When omitted, every status except archived is returned.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.Response
object[]
required
Assistant summaries, ordered by
updated_at, newest first.Show properties
Show properties
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.
integer
required
How many knowledge bases the assistant answers from.
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?status=active&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/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())
const params = new URLSearchParams({ status: 'active', limit: '20' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/assistants?${params}`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"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"
}
]
}
{ "code": "validation_error", "message": "'status' is not a recognised value." }
Last modified on November 7, 2026
curl --request GET "$MITHUNAI_URL/mithunai/api/v1/assistants?status=active&limit=20" \
--header "Authorization: Bearer $MITHUNAI_API_KEY"
import os, requests
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/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())
const params = new URLSearchParams({ status: 'active', limit: '20' })
const response = await fetch(`${process.env.MITHUNAI_URL}/mithunai/api/v1/assistants?${params}`, {
headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
})
console.log(await response.json())
{
"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"
}
]
}
{ "code": "validation_error", "message": "'status' is not a recognised value." }