List the assistants in your organisation
List assistants as summaries, most recently updated first. A summary carries no instruction and a knowledge-base count rather than ids; archived ones omitted.
GET
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.Last modified on September 26, 2026