Returns the list of currently logged-on users for each of the specified computers. Used to allow technicians to select specific users when executing a logoff-targeted shutdown operation.
post /dcapi/tools/shutdown/getLoggedOnUsers
https://{server-hostname}:8383/dcapi/tools/shutdown/getLoggedOnUsers Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request POST \
--url https://appdomain/dcapi/tools/shutdown/getLoggedOnUsers \
--header 'Accept: application/loggedOnUsersList.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/getLoggedOnUsersParams.v1+json' \
--data '{"computers":[101,202,303]}' {
"computers": [
101,
202,
303
]
}
Array of computer objects with resourceId, computerName, and a nested users array containing userName and domainName
{
"loggedOnUsers": [
{
"resourceId": 101,
"computerName": "WIN-DESKTOP-01",
"users": [
{
"domainName": "CORP",
"userName": "john.doe"
}
]
}
]
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.