Polling endpoint to check whether the agent has completed a user refresh and the logged-on users list has been updated. A user refresh must be triggered first via the /users endpoint.
get /dcapi/tools/{resourceId}/userStatus
https://{serverurl}/dcapi/tools/{resourceId}/userStatus
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique identifier of the target device
curl --request GET \
--url https://appdomains/dcapi/tools/{resourceId}/userStatus \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'true if the agent has completed the user refresh and the logged-on users list is up to date
Current version counter of the logged-on users data; increments on each refresh
{
"isUpdated": true,
"version": 7
}
![]()
Duration: 1 minute | Threshold: 300 | 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.