SPspectate
Members

Change a member's role

The owner's role can't change, and nobody becomes owner this way (403 TEAM_OWNER_PROTECTED). The API can't transfer ownership: only the owner can, in the dashboard (Team → Settings), after confirming their password.

patch/members/{member}

Request

  • Base URL
    https://api.spectate.net/v1
  • Auth
    HTTP bearer

Path parameters

memberstring uuid required

Member (user) ID.

Request body

role'owner' | 'manager' | 'admin' | 'member' | 'billing' required

A member's role in the team: what they may do.

owner <br/> Everything, including billing and deleting the team. One per team.
manager <br/> Everything but billing and deleting the team.
admin <br/> Configure monitoring, alerting, incidents and status pages; can't manage members or API tokens.
member <br/> Read everything; manage monitors and incidents, acknowledge alerts.
billing <br/> Billing and support only.

Response

The member with the new role.

idstring uuid required

Member (user) ID

namestring required

Name

emailstring email required

Email address

role'owner' | 'manager' | 'admin' | 'member' | 'billing' required

A member's role in the team: what they may do.

owner <br/> Everything, including billing and deleting the team. One per team.
manager <br/> Everything but billing and deleting the team.
admin <br/> Configure monitoring, alerting, incidents and status pages; can't manage members or API tokens.
member <br/> Read everything; manage monitors and incidents, acknowledge alerts.
billing <br/> Billing and support only.
joined_atstring date-time nullable required

When they joined the team

Example response

{
  "name": "Jane Doe",
  "email": "jane@example.com"
}

Changes

No recorded changes to this operation across all 1 revision of this API.