Updating user roles using the xMatters API

Question 

Can I update user roles using the xMatters API?

Environment

All versions of xMatters

Answer

Yes, as a role is a property of a user, by modifying a user in the system, you can update their roles using a curl command.

For example:

curl -H "Content-Type: application/json" --user username -X POST -d 
'{
  "id": "personUUID",
    "roles":["Standard User","Group Supervisor","Developer"],
}' 
"https://acmeco.xmatters.com/api/xm/1/people" 

Note: You will need to have the user's UUID to be able to call them up and modify as needed.

To learn about about modifying users through the xMatters API, see Modify a person.