Sign in

v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
platformApi

Api Admin Staff Groups Retrieve

GET / PATCH / DELETE /api/admin/staff-groups/<name>/

DELETE soft-disables the group (sets revoked_at + actor email). All members lose authority atomically per the resolver's group- revoked check.

get/api/admin/staff-groups/{name}/

Path parameters

namestring required

Headers

Authorizationstring required

JWT access token or Respan API key

Response

idstring required
namestring required
descriptionstring
permissions_overridestring[]
granted_byinteger nullable required
granted_atstring date-time required
revoked_atstring date-time nullable required
revoked_by_emailstring nullable required
member_countinteger required

Active (non-revoked) members of this group. Tiny — staff roster is bounded, so the COUNT runs without a separate query when the queryset annotates it; otherwise it's a cheap COUNT.