---
title: "Api Admin Staff Groups Create"
method: POST
path: "/api/admin/staff-groups/"
tags: ["platformApi"]
---

# Api Admin Staff Groups Create

`POST /api/admin/staff-groups/`

POST handler with superadmin-only field protection.

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

## Headers

- `Authorization` string, required

## Request body

- StaffGroupRequest — Group CRUD shape. ``name`` is the external identifier; the UUID ``id`` is read-only. POST body: { "name": "engineering_admins", "permissions_override": ["staff_read", "staff_write"], "description": "Engineering team admins" } PATCH body: any subset of {permissions_override, description}. Renaming a group is allowed via PATCH(name); the UUID stays stable so existing memberships don't break.
  - `name` string, required
  - `description` string
  - `permissions_override` string[]

## Response `201`

- StaffGroup — Group CRUD shape. ``name`` is the external identifier; the UUID ``id`` is read-only. POST body: { "name": "engineering_admins", "permissions_override": ["staff_read", "staff_write"], "description": "Engineering team admins" } PATCH body: any subset of {permissions_override, description}. Renaming a group is allowed via PATCH(name); the UUID stays stable so existing memberships don't break.
  - `id` string, required
  - `name` string, required
  - `description` string
  - `permissions_override` string[]
  - `granted_by` integer, nullable, required
  - `granted_at` string, date-time, required
  - `revoked_at` string, date-time, nullable, required
  - `revoked_by_email` string, nullable, required
  - `member_count` integer, 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.

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)