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://{serverurl}/dcapi/tools/shutdown/getLoggedOnUsers
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
curl --request POST \
--url https://appdomains/dcapi/tools/shutdown/getLoggedOnUsers \
--header 'Accept: application/loggedOnUsersList.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/getLoggedOnUsersParams.v1+json' \
--data '{}' {
"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.