Initiates agent installation on one or more computers that are already in the Scope of Management. Returns categorized lists of computers by OS type and agent availability.
post /dcapi/som/computers/installAgent
https://{server-hostname}:8383/dcapi/som/computers/installAgent
SOM.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Array of computer resource IDs to perform the operation, get computer IDs from the response of the Computers API, under the resource_id field.
curl --request POST \
--url https://appdomain/dcapi/som/computers/installAgent \
--header 'Accept: application/somComputerInstallStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/computerIdsToInstallAgent.v1+json' \
--data '{"computerIDs":["1001","1002","1003"]}'Install agent on multiple computers
{
"computerIDs": [
"1001",
"1002",
"1003"
]
}
Number of Azure AD-joined computers included in the installation request
Array of resource IDs originally submitted in the installation request
Array of resource IDs for computers where the agent can be installed (meets prerequisites)
Array of resource IDs for Windows computers eligible for agent installation
Array of resource IDs for computers located in WAN/remote branch offices
Array of resource IDs for macOS computers eligible for agent installation
Array of resource IDs for Linux computers eligible for agent installation
Indicates whether macOS agent distribution settings have been configured on the server
Indicates whether Linux agent distribution settings have been configured on the server
HTTP status code (400)
API-specific error code identifying the validation failure
Error message describing the validation failure
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
Agent install initiated
{
"containsAzureADComputers": 0,
"windowsComputers": [
"1001"
],
"macComputers": [],
"agentAvailableComputers": [
"1001",
"1002"
],
"isMacSettingsConfigured": true,
"wanComputers": [
"1002"
],
"linuxComputers": [],
"requestedComputers": [
"1001",
"1002",
"1003"
],
"isLinuxSettingsConfigured": false
}
Missing or empty computerIDs in request
{
"errorCode": "20006",
"message": "Resource IDs are not present in the request",
"statusCode": 400
}
Non-admin user cannot access the requested computers
{
"errorCode": "20005",
"message": "Selected computers are not accessible",
"statusCode": 412
}
Some computers are not managed by the server
{
"errorCode": "30007",
"message": "All resources are not managed computers",
"statusCode": 412
}
Linux agent settings not configured
{
"errorCode": "30010",
"message": "Linux agent settings are not configured",
"statusCode": 412
}
![]()
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.