Moves one or more computers from their current remote office to a different remote office.
post /dcapi/som/computers/moveRemoteOffice
https://{serverurl}/dcapi/som/computers/moveRemoteOffice
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of computer resource IDs to move to the target remote office, get resource ids from Get Computers
Identifier of the target remote office to move the computers into. Fetch available IDs from Get Remote Offices
curl --request POST \
--url https://appdomains/dcapi/som/computers/moveRemoteOffice \
--header 'Accept: application/computerMoveStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/computersToMoveRO.v1+json' \
--data '{"computerIDs":["4001","4002","4003","4004"]}'Move computers to a different remote office
{
"computerIDs": [
"4001",
"4002",
"4003",
"4004"
],
"remoteOfficeID": 501
}
Indicates whether the remote office move operation was accepted and initiated successfully
Status indicator for the move operation: 'YetToInstall' when the agent is not yet installed on the target, 'NSRequired' when Notification Service is required to complete the move
HTTP status code (400)
API-specific error code identifying the validation failure
Error message describing the validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
HTTP status code (404)
Error code identifying the resource that was not found
Error message describing the missing resource
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
Move initiated
{
"message": "YetToInstall",
"status": true
}
Missing or empty computerIDs in request
{
"errorCode": "20006",
"message": "Resource IDs are not present in the request",
"statusCode": 400
}
Another move operation is already in progress
{
"errorCode": "30041",
"message": "Agent move operation is already running",
"statusCode": 400
}
Custom group scope user is not allowed to move computers
{
"errorCode": "1001",
"message": "Unauthorized",
"statusCode": 401
}
Target remote office not found
{
"errorCode": "30028",
"message": "Remote office not found",
"statusCode": 404
}
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
}
All agents are already in the target remote office
{
"errorCode": "30040",
"message": "All agents are already in the target remote office",
"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.