Agent Groups

List agent groups in an organization

List the active agent groups for an organization. With no q, groups are returned ordered by creation time (newest first). With q, groups are filtered by a case-insensitive name search and ranked most-relevant-first (exact → prefix → fuzzy, then recency, then member count) so a suggestion UI can offer existing groups. Each item carries a match_type discriminator (none when no q was supplied). Optional limit/offset bound the response; when neither is supplied the legacy { groups } envelope is returned unchanged. Returns an empty array when nothing matches.

get/agent-groups

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/agent-groups
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key

Query parameters

org_idstring required

Organization whose groups to list

qstring

Optional case-insensitive name search. When present, non-matching groups are dropped and the rest are ranked exact → prefix → fuzzy.

limitinteger

Optional page size, clamped to [1, 200] (defaults to 50 when only offset is supplied). Bounds the response after ranking so the highest-ranked suggestions survive truncation.

offsetinteger

Optional row offset (≥ 0) into the ranked result.

Response

List of active groups (filtered + ranked when q is supplied)

totalinteger

Total matched groups before paging (present only when paginated).

limitinteger

Applied page size (present only when paginated).

offsetinteger

Applied row offset (present only when paginated).

Changes

No recorded changes to this operation across all 1 revision of this API.