Update User Delegates

Update the delegates assigned to a user.

Update the delegates assigned to a user

post

/v1/admin/user/{uid}/delegates/update

Path parameters

uidinteger · int64required

User ID as a decimal integer

Header parameters

sessionTokenstringrequired

Session authentication token.

Body

userIdinteger · int64

Example: 7215545078461

actionstring · enum

Example: ADD

Options: ADD, REMOVE

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/admin/user/{uid}/delegates/update' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '{"userId":7215545078461,"action":"ADD"}'

200

400

401

403

500

200

{
  "format": "TEXT",
  "message": "Added delegate [7215545078461] for account [7215545078541]"
}

Sucesss.

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.