PATCH /public/v1/workspaces/{workspace_id}/members/{member_id}/role
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
rolefield 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
Guestlicense is promoted to any non-Collaboratorrole, the user's license is automatically upgraded toFull (Standard). If the organization has no free seats available, an additional seat is purchased.
Servers
- https://api.pandadoc.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
member_id |
String | Yes |
Member id. |
workspace_id |
String | Yes |
Workspace id. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
role |
String | Yes |
Role for a member. Valid values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.