rbac

Create group

Changed on Oct 16, 2026

Creates a group whose members get the group's roles. Requires an Enterprise plan or the RBAC add-on. The name must be unique, every role ID must exist, and you can't add yourself as a member.

post/rbac/groups

Request

Base URL
https://api.axiom.co/v2
Auth
OAuth 2
Authorization codehttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://www.googleapis.com/oauth2/v4/token
Scopesrbac|create
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/rbac/groups/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

descriptionstring

Detailed description of the group's purpose and scope

isManagedboolean

Whether the group is synced from your identity provider. You can't delete a managed group or change its members.

membersstring[]

List of user IDs that are assigned to this group

namestring required

Unique name identifier for the group

rolesstring[]

IDs of the roles assigned to the group. Use a custom role ID or a built-in role ID: axiom-owner, axiom-admin, axiom-user, axiom-read-only, or axiom-none.

Response

The created group.