Skip to main content
GET
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.
Last modified on September 26, 2026