Skip to main content
POST
Create a group.

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Body

application/json
name
string
required

Label is only used for the presentation.

Example:

"Operations"

ownerId
string
required

Owning user or group id that governs this group.

Example:

"22222222-2222-4222-8222-222222222222"

ownerType
enum<string>
required

Owner principal type for the governing ownerId.

Available options:
USER,
GROUP
Example:

"USER"

category
string

Optional presentation category used to group similar teams.

Example:

"Operations"

desc
string

Operator-visible description shown in group details.

Example:

"Primary operations on-call rotation."

metadata
object

Optional resource metadata. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.

Example:
members
string[]

Optional user ids to attach as group members during creation.

Example:

Response

Created.

Last modified on September 5, 2026