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
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