User Status

Get the status, active or inactive, for a particular user.

Get the status, active or inactive, for a particular user

GETyourpodURL.symphony.com/pod/v1/admin/user/{uid}/status

Path parameters

uid*integer (int64)

User ID as a decimal integer

Header parameters

Response

200400401403500

Success

Body

application/json

statusenum

ENABLEDDISABLED

suspendedboolean

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

suspendedUntilinteger (int64)

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

suspensionReasonstring

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

Request

JavaScriptCurl

const response = await fetch('yourpodURL.symphony.com/pod/v1/admin/user/{uid}/status', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

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

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