---
title: "Change Team Member Role"
method: PATCH
path: "/team-member/role"
tags: ["Teams"]
---

# Change Team Member Role

`PATCH /team-member/role`

Change a team member's organization role and/or their role on one or more WhatsApp Business Accounts (WABA). At least one of orgRole or wabaRoles must be provided.

## Request body

- ChangeTeamMemberRoleDto
  - `memberPhoneNumber` string, required — Phone number (with country code) of the team member whose roles are being changed.
  - `orgRole` RoleReferenceDto
    - `roleId` string — Role id as returned by Get All Roles. Provide exactly one of roleId or roleName.
    - `roleName` string — Role name as returned by Get All Roles. Provide exactly one of roleId or roleName. Matched exactly (case-sensitive).
  - `wabaRoles` WabaRoleChangeDto[] — Per-WABA role changes for the member. Each entry references its role by EITHER roleId OR roleName (both are returned by Get All Roles) — the example below shows one of each. Optional, but at least one of orgRole or wabaRoles must be provided. Duplicate wabaNumber entries are rejected.
    - `wabaNumber` string, required — WhatsApp Business Account number (with country code) to apply the role change to.
    - `roleId` string — WABA role id as returned by Get All Roles. Provide exactly one of roleId or roleName.
    - `roleName` string — WABA role name as returned by Get All Roles. Provide exactly one of roleId or roleName. Matched exactly (case-sensitive).

## Response `200`

Resulting role state of the team member

- ChangeTeamMemberRoleResponseDto
  - `success` boolean, required
  - `memberPhoneNumber` string, required — Phone number of the team member whose role was changed
  - `orgRoleId` string — Resulting org role id. Present only if orgRole was requested.
  - `orgRoleName` string — Resulting org role name. Present only if orgRole was requested.
  - `wabaRoles` ChangeTeamMemberRoleWabaRolesResultDto
    - `added` ChangeTeamMemberRoleWabaRoleResponseDto[], required — Entries that were applied successfully
      - `wabaNumber` string, required — WABA number the role change was applied to
      - `wabaName` string, nullable, required — Display name of the WABA
      - `roleId` string, required — Resulting WABA role id
      - `roleName` string, required — Resulting WABA role name
    - `errored` ChangeTeamMemberRoleWabaRoleErrorDto[], required — Entries that failed validation. Valid entries are still applied.
      - `wabaNumber` string, required — WABA number of the entry that failed validation
      - `error` string, required — Why the entry was not applied

## Other responses

- `400` — Incorrect payload
- `401` — Unauthorized
- `422` — The team member, role, or WABA could not be resolved.

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)