Suspend User Account

Suspend or re-activate (unsuspend) a user account.

Released in Symphony 20.7.

Update the status of suspension of a particular user

put

Path parameters

userIdanyrequired

User ID as a decimal integer

Header parameters

sessionTokenanyrequired

Session authentication token

Body

suspendedbooleanoptionalExample: true

suspendedUntilinteger · int64optionalExample: 1601546400

suspensionReasonstringoptionalExample: The user will be OOO due to a mandatory leave

Responses

application/json

objectoptional

application/json

application/json

application/json

application/json

put

HTTPcURLJavaScriptPython

PUT /pod/v1/admin/user/{userId}/suspension/update HTTP/1.1
Host: yourpodURL.symphony.com
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "suspended": true,
  "suspendedUntil": 1601546400,
  "suspensionReason": "The user will be OOO due to a mandatory leave"
}

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

The value of the suspendedUntil field should be provided in milliseconds

Request Examples

curl -X PUT \
 'https://devx1.symphony.com/pod/v1/admin/user/12987981107250/suspension/update' \
-H 'sessionToken: SESSION_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
      "suspended": true,
      "suspensionReason": "The user will be OOO due to a mandatory leave",
      "suspendedUntil": 1601546400000
    }'

curl -X PUT \
 'https://devx1.symphony.com/pod/v1/admin/user/suspension/update' \
-H 'sessionToken: SESSION_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
      "suspended": false
    }'

📘 Required Fields

When suspending a user account, suspended=true, all three body parameters are required. When activating a user account, suspended=false, the other two remaining body parameters are not required.

🚧 Required Permissions

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