Update User Delegates

Update the delegates assigned to a user.

Update the delegates assigned to a user

POSTyourpodURL.symphony.com/pod/v1/admin/user/{uid}/delegates/update

Path parameters

uid*integer (int64)

User ID as a decimal integer

Header parameters

Body

application/json

userIdinteger (int64)

Example: 7215545078461

actionenum

Example: "ADD"

ADDREMOVE

Response

200400401403500

Sucesss.

Body

application/json

formatenum

Example: "TEXT"

TEXTXML

messagestring

Example: "Success"

Request

JavaScriptCurlPython

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

Response

200400401403500

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

As the example shows, the action to be performed (ADD or REMOVE) and the user to be added or removed as a delegate (specified by user ID) must be included in the data parameter.

🚧 Roles and Privileges

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