Skip to main content
PUT
/
v1
/
workspaces
/
{id}
/
members
/
{userId}
Update Workspace Member Role
curl --request PUT \
  --url https://api.vertracloud.app/v1/workspaces/{id}/members/{userId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "role": "<string>"
}
'
{}
​
id
string
required
The ID of the workspace.
​
userId
string
required
The ID of the user whose role is to be updated.
​
role
string
required
The new role for the member. Must be one of: owner, admin, developer, operator, viewer.

​
Response

{}

​
Error Responses

​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated.
  • ONLY_OWNER_CAN_UPDATE_ROLE: Only the workspace owner can update member roles.
  • CANNOT_CHANGE_OWNER_ROLE: The owner’s role cannot be changed.
  • INVALID_ROLE: The provided role is invalid.
  • MEMBER_NOT_FOUND: The specified user is not a member of the workspace.
  • ORG_ID_MUST_BE_STRING: The provided workspace_id is not a string.
  • USER_ID_MUST_BE_STRING: The provided user ID is not a string.
  • ROLE_MUST_BE_STRING: The provided role is not a string.
​
message
string
A descriptive message providing additional details about the error.
{
  "code": "UNAUTHORIZED"
}