Sends a refresh command to the agent on the specified computer to update the currently logged-on users list. The refreshed data can be polled via the userStatus endpoint.
get /dcapi/tools/{resourceId}/users
https://{serverurl}/dcapi/tools/{resourceId}/users
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique identifier of the target device
curl --request GET \
--url https://appdomains/dcapi/tools/{resourceId}/users \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Status of the refresh trigger: refresh_triggered or failed
Resource identifier of the computer for which the refresh was triggered
{
"resourceId": 101,
"status": "refresh_triggered"
}
![]()
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.