Sign In
APIsManagement APIUsersAssign a user to a group POST

Assign a user to a group

View as Markdown
POST
/users/{user_id}/groups/{group_id}

Adds the specified user to the group, establishing membership and enabling access configurations assigned to that group.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

user_id*string

The unique identifier of the user.

group_id*string

The unique identifier of the group.

Formatuuid

Response Headers

201

location?string

Returns the location header

Formaturi

Response Body

201

application/json

The user was assigned to the group successfully

TypeScript Definitions

Use the response body type in TypeScript.

User Group: Represents the membership of a user in a group.

Errors

401Unauthorized
403Forbidden

curl -X POST "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/groups/b4835fe2-5d39-4ff8-a1b6-1699b5899ff8" \  -H "X-API-KEY: <token>"
{  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",  "user_id": "string",  "creation_time": 0,  "group_name": "string"}

Retrieve a user group GET

Retrieves information about the specified group and the user’s membership in it.

Remove a user from a group DELETE

Removes the specified user from the group. After removal, the user will no longer receive any access, permissions, or roles previously granted through that group.

© 2026 MonoCloud. All rights reserved.