Skip to main content
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