User and Workspace management
Change Member Role in Workspace
Change the role of an existing workspace member.
- You must be an organization admin, a workspace admin, or hold a role with permission to edit member roles to call this endpoint.
- The role field accepts either a built-in role name (Admin, Manager, Member, Collaborator) or the name of a custom role defined for the workspace.
- The role of the workspace owner cannot be changed.
- The role of the last member with admin privileges in the workspace cannot be changed.
- When a member with a Guest license is promoted to any non-Collaborator role, the user's license is automatically upgraded to Full (Standard). If the organization has no free seats available, an additional seat is purchased.
patch/public/v1/workspaces/{workspace_id}/members/{member_id}/role
Path parameters
workspace_idstring required
Workspace id.
member_idstring required
Member id.
Request body
Example request
{
"role": "Member"
}Response
OK
Example response
{
"member_id": "iMymdDd9XFD3HyxP5VD67Q",
"workspace_id": "2eWSKSvVqmuVCnuUK3iWwD",
"role": "Member",
"email": "email@example.com"
}