Users

PUT /users/{id}/role

Changed on

Changes the role of a member of the organization and returns the updated user. You can't change your own role. Only owners using a personal access token (PAT) can assign owner or change an owner's role.

Request

Path parameters

idstring required

Request body

rolestring required

Role identifier to assign to the user

Example request

{
  "role": "admin"
}

Response

Updated user.

emailstring required

User's email address

idstring required

Unique identifier for the user

namestring required

User's full name

Example response

{
  "email": "john.doe@example.com",
  "id": "usr_123456789",
  "name": "John Doe",
  "role": {
    "id": "role_123456789",
    "name": "Organization Admin"
  }
}

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status