Skip to main content
GET
List agent groups in an organization

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Query Parameters

org_id
string
required

Organization whose groups to list

q
string

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

limit
integer
default:50

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.

Required range: 1 <= x <= 200
offset
integer
default:0

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

Required range: x >= 0

Response

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

groups
object[]
required
total
integer

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

limit
integer

Applied page size (present only when paginated).

offset
integer

Applied row offset (present only when paginated).