Skip to main content
PATCH
Change a member's role

Authorizations

Authorization
string
header
required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Path Parameters

team
string
required

The team UUID

Example:

"fbb31f5f-bd6f-4019-a3ed-1062a28f56f7"

member
string
required

The member UUID

Example:

"b80181be-bb65-4aca-9246-e7335f330a34"

Body

application/json

Send a JSON object containing the fields below. Required fields are marked in the schema.

role_id
string
required

The role id ID.

Required string length: 36

Response

The record, as a JSON object. There is no envelope.

A team member and their assigned role.

id
string
required

The id ID.

Example:

"b80181be-bb65-4aca-9246-e7335f330a34"

name
string | null
required

The name shown to customers.

Example:

"Barney Calhoun"

email
string | null
required

The email address.

Example:

"barney.calhoun@blackmesa.example.com"

role
TeamRoleSummaryData · object | null
required

The value of role.

Example:
joined_at
string | null
required

The date and time for joined at, in UTC.

Example:

"2026-01-12T17:31:05+00:00"

created_at
string | null
required

The date and time for created at, in UTC.

Example:

"2026-01-12T17:31:05+00:00"

gravatar_url
string | null
required

The value of gravatar_url.

Example:

"https://www.gravatar.com/avatar/52fe79725661c25ad4a3f683abc54c3a?s=64&d=404"