Update User Status

Update the status of a particular user.

Update the status of a particular user

post

Path parameters

uidanyrequired

User ID as a decimal integer

Header parameters

sessionTokenanyrequired

Session authentication token.

Body

statusstring · enumoptionalExample: ENABLEDAvailable options:

suspendedbooleanoptional

An optional attribute indicating whether the user is temporarily suspended or not. Since SBE 20.14.

Example: true

suspendedUntilinteger · int64optional

An optional unix timestamp until which the suspension is effective. Since SBE 20.14.

Example: 1601546400

suspensionReasonstringoptional

An optional description of the suspension reason. Since SBE 20.14.

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

Responses

application/json

objectoptional

application/json

application/json

application/json

application/json

post

HTTPcURLJavaScriptPython

POST /pod/v1/admin/user/{uid}/status/update HTTP/1.1
Host: yourpodURL.symphony.com
Content-Type: application/json
Accept: */*
Content-Length: 132

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

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

📘 Note

It is not possible to disable protected service users (keymanager and ceservice)

🚧 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.