Add Role

Adds a role or optional entitleable action to a user’s account.

Add a role to a user

POSTyourpodURL.symphony.com/pod/v1/admin/user/{uid}/roles/add

Path parameters

uid*integer (int64)

User ID as a decimal integer

Header parameters

Body

application/json

idstring

Example: "xhGxbTcvTDK6EIMMrwdOrX___quztr2HdA"

Response

200400401403500

Success

Body

application/json

formatenum

Example: "TEXT"

TEXTXML

messagestring

Example: "Success"

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/admin/user/{uid}/roles/add', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403500

{
  "format": "TEXT",
  "message": "Success"
}

Request Example

curl -X POST \
	https://acme.symphony.com/pod/v1/admin/user/346147139412345/roles/add \
  -H 'cache-control: no-cache' \
	-H 'content-type: application/json' \
	-H 'sessiontoken: SESSION_TOKEN' \
	-d '{"id":"COMPLIANCE_OFFICER"}'

🚧 Required Permissions

Calling this endpoint requires the User Provisioning role with ACCESS_USER_PROVISIONING_API privilege. See Bot Permissions for a list of roles and associated privileges.