Retrieves the current status and progress of an agent installation operation including completed, total, and WAN computer counts.
get /dcapi/som/computers/agentInstallStatus
https://{serverurl}/dcapi/som/computers/agentInstallStatus
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
curl --request GET \
--url https://appdomains/dcapi/som/computers/agentInstallStatus \
--header 'Accept: application/somComputerAgentInstallationStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Whether agent installation is currently in progress
Number of computers where installation completed (success or fail)
Total number of computers targeted for installation
Number of WAN/remote computers in the install batch
Number of computers where installation failed. Present only if failures exist
Count of failed installations eligible for retry
Whether the agent install workflow was stopped by the user
Installation in progress
{
"totalComputerCount": 10,
"wanComputerCount": 3,
"completedComputerCount": 5,
"installInProgress": true
}
Installation completed with failures
{
"totalComputerCount": 10,
"wanComputerCount": 3,
"completedComputerCount": 10,
"installFailedCount": 2,
"retryInstallFailedCount": "1",
"installInProgress": false
}
![]()
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.