Change team member role

PATCH /api/v2/users/:agent_uuid/role - Updates a member role to admin or agent.

PATCH/api/v2/users/:agent_uuid/role

Updates a member role to admin or agent.

Required scope: users (or *).

Path parameters

NameRequiredDescription
agent_uuidYesAgent UUID

JSON body

NameRequiredDescription
roleYesadmin or agent

Example request

curl -s -X PATCH -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin"
}' \
  "https://benefitpath.com/api/v2/users/c0a80101-0000-4000-8000-000000000003/role"

Example response

{
  "success": true,
  "agent_uuid": "c0a80101-0000-4000-8000-000000000003",
  "role": "admin"
}

See Team and Errors.