User Status

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

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

get

Path parameters

uidinteger · int64Required

User ID as a decimal integer

Header parameters

sessionTokenstringRequired

Session authentication token.

Responses

200

Success

application/json

statusstring · enumOptionalExample: ENABLEDPossible values:

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

400

Client error, see response body for further details.

application/json

401

Unauthorized: Invalid session token.

application/json

403

Forbidden: Caller lacks necessary entitlement.

application/json

500

Server error, see response body for further details.

application/json

get

/v1/admin/user/{uid}/status

HTTPcURLJavaScriptPython

GET /pod/v1/admin/user/{uid}/status HTTP/1.1
Host: yourpodURL.symphony.com
sessionToken: text
Accept: */*

{
  "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.