Skip to main content
POST
Create a new group

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request model for creating a new group.

name
string
required

Unique name for the group (lowercase letters, numbers, underscores, and colons only)

Required string length: 1 - 100
Pattern: ^[a-z0-9_:]+$
Example:

"engineering_team:backend"

description
string
required

Human-readable description of the group's purpose

Required string length: 1 - 500
Example:

"Engineering team with access to development resources"

Response

Group created successfully

Response model for group information.

id
integer
required

Unique identifier for the group

Example:

1

name
string
required

Group name

Example:

"engineering_team:backend"

description
string
required

Group description

Example:

"Engineering team with access to development resources"

created_at
string
required

ISO timestamp when the group was created

Example:

"2024-01-15T10:30:00Z"

created_by
string | null

CPF of the user who created this group

Example:

"12345678901"