Change a person's role

Before you call

Credential

Authorization: Bearer $KEY

Scope

workspace:admin

Graphql

Mutation.workspacePeopleSetRole

Sdk

workspace.people.setRole

Cli

workspace people set role

Parameters

• idstring (uuid)required
  In the path

Request bodyapplication/json, required

• rolestringrequired
  One of: owner, manager, approver, editor, agent, viewer, accountant.

Responses

• 200application/json
  Success

  object

• 400application/json
  The request was malformed
  • errorstringrequired
  • messagestring
• 401application/json
  No valid credential
  • errorstringrequired
  • messagestring
• 403application/json
  The credential lacks the scope, origin or address
  • errorstringrequired
  • messagestring
• 429application/json
  Over the key's rate limit; see Retry-After
  • errorstringrequired
  • messagestring