Add member to group

Add a user to a group with automatic user creation and authorization checks.

Authorization: Users can add members to groups they have permission to manage. Permissions are checked via Cerbos policies.

Auto-Creation: If the user being added doesn’t exist in the system, they will be automatically created with their CPF as the identifier.

Member Identification: Users are identified by their CPF (Brazilian tax ID), which serves as the unique subject identifier.

Use Cases:

• Add team members to project groups
• Grant users access to specific resources
• Administrative user management
• Bulk user provisioning workflows

Role Inheritance: Users automatically inherit all roles assigned to groups they’re members of.

Authorizations

Authorization · string · header · required

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

Path Parameters

group_name · string · required

Body

application/json

Request model for adding a member to a group.

subject · string · required

User's CPF (Brazilian tax ID) to add to the group

Example:

"12345678901"

Response

200

application/json

Member added to group successfully

Response model for membership operations.

status · string · required

Status of the membership operation

Example:

"member_added"

group · string · required

Name of the group

Example:

"engineering_team:backend"

subject · string · required

CPF of the user involved in the operation

Example:

"12345678901"