v3

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

Api Admin Staff Groups Create

POST handler with superadmin-only field protection.

Strips superadmin-only fields from non-superadmin requests before delegating to OrganizationInjectionMixin.post() for org injection.

post/api/admin/staff-groups/

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

namestring required
descriptionstring
permissions_overridestring[]

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.