Update User Role

curl --request PATCH \
  --url https://app.getcensus.com/api/v1/users/{user_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user": {
    "role": "admin"
  }
}
'

{
  "status": "updated",
  "data": {
    "id": 123,
    "email": "[email protected]",
    "created_at": "2023-08-20T10:00:00Z",
    "role": "admin"
  }
}

PATCH

users

{user_id}

Update User Role

curl --request PATCH \
  --url https://app.getcensus.com/api/v1/users/{user_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user": {
    "role": "admin"
  }
}
'

{
  "status": "updated",
  "data": {
    "id": 123,
    "email": "[email protected]",
    "created_at": "2023-08-20T10:00:00Z",
    "role": "admin"
  }
}

Authorizations

Authorization

string

header

required

Bearer authorization using your Personal Access Token. Generate a new PAT on your user settings page.

Path Parameters

user_id

integer

required

ID of the user

Body

application/json

user

object

required

Show child attributes

user.role

enum<string>

required

User's role in the organization.

Available options:

admin,

member

Example:

"admin"

Response

success

status

enum<string>

required

Outcome of update request

Available options:

updated

Example:

"updated"

data

object

required

Show child attributes

data.id

integer

required

Unique identifier for the user.

data.email

string

required

User's email address.

Example:

"[email protected]"

data.created_at

string<date-time>

required

Timestamp of user account creation.

Example:

"2023-08-20T10:00:00Z"

data.role

enum<string>

required

User's role in the organization.

Available options:

admin,

member

Example:

"admin"

Remove User List invitations

⌘I

Introduction

Organization APIs

Workspace APIs

Update User Role

Authorizations

Path Parameters

Body

Response