Skip to main content
Use this endpoint to change the permission group assigned to an existing workspace member. This is useful when a team member’s responsibilities change and they need expanded or restricted access to workspace applications. Only workspace owners and admins can update member permissions.

​
Request

PATCH https://api.virtuscloud.app/v2/workspaces/members

​
Headers

​
Authorization
string
required
Your Virtus Cloud API key. Pass it directly as the header value — no prefix required.Example: Authorization: vc_live_xxxxxxxxxxxx

​
Body

​
workspaceId
string
required
The unique identifier of the workspace containing the member whose permissions you want to update.
​
memberId
string
required
The user ID of the member whose permission group you want to change. Retrieve member IDs from the Get Workspace endpoint.
​
group
string
required
The new permission group to assign to the member. This controls what actions the member can take on workspace applications.

​
Response

​
status
string
Returns "success" when the member’s permissions are updated successfully.

​
Examples

curl -X PATCH https://api.virtuscloud.app/v2/workspaces/members \
  -H "Authorization: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "dcedcd13d7e272a7b32a70f6a1d180f23c12d759",
    "memberId": "5354d9742d889d49b20134ba0be09ccc0033be68",
    "group": "admin"
  }'

​
Response Example

{
  "status": "success"
}