# Move computers to a different remote office

Moves one or more computers from their current remote office to a different remote office.

## Endpoint

**POST** `/dcapi/som/computers/moveRemoteOffice`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/som/computers/moveRemoteOffice`

### Scope

`SOM.CREATE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

| Name | Type | Required | Value |
|---|---|---|---|
| Content-Type | string | Mandatory | `application/computersToMoveRO.v1+json` |
| Accept | string | Mandatory | `application/computerMoveStatus.v1+json` |

#### Request Body

`application/json`

| Attribute | Type | Required | Description |
|---|---|---|---|
| computerIDs | JSON Array | Mandatory | Array of computer resource IDs to move to the target remote office. Get resource IDs from [Get Computers](https://www.manageengine.com/products/desktop-central/help/api/onpremise/computers-getcomputers.html). |
| remoteOfficeID | string | Optional | Identifier of the target remote office to move the computers into. Fetch available IDs from [Get Remote Offices](https://www.manageengine.com/products/desktop-central/help/api/onpremise/remoteoffices_getremoteoffice.html). |

`computerIDs` array items are `string`.

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/dcapi/som/computers/moveRemoteOffice \
  --header 'Accept: application/computerMoveStatus.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/computersToMoveRO.v1+json' \
  --data '{"computerIDs":["4001","4002","4003","4004"],"remoteOfficeID":501}'
```

### Sample Request Body

Move computers to a different remote office

```json
{
  "computerIDs": [
    "4001",
    "4002",
    "4003",
    "4004"
  ],
  "remoteOfficeID": 501
}
```

## Response

### HTTP 200

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| status | boolean | Indicates whether the remote office move operation was accepted and initiated successfully. |
| message | string | 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. |

#### Sample Response: HTTP 200

Move initiated

```json
{
  "message": "YetToInstall",
  "status": true
}
```

### HTTP 400

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| statusCode | string | HTTP status code (400). |
| errorCode | string | API-specific error code identifying the validation failure. |
| message | string | Error message describing the validation failure. |

#### Sample Response: HTTP 400

Missing or empty computerIDs in request

```json
{
  "errorCode": "20006",
  "message": "Resource IDs are not present in the request",
  "statusCode": 400
}
```

Another move operation is already in progress

```json
{
  "errorCode": "30041",
  "message": "Agent move operation is already running",
  "statusCode": 400
}
```

### HTTP 401

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| errorCode | long | Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required). |
| errorMsg | string | Authentication failure reason. |

#### Sample Response: HTTP 401

Custom group scope user is not allowed to move computers

```json
{
  "errorCode": "1001",
  "message": "Unauthorized",
  "statusCode": 401
}
```

### HTTP 404

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| statusCode | string | HTTP status code (404). |
| errorCode | string | Error code identifying the resource that was not found. |
| message | string | Error message describing the missing resource. |

#### Sample Response: HTTP 404

Target remote office not found

```json
{
  "errorCode": "30028",
  "message": "Remote office not found",
  "statusCode": 404
}
```

### HTTP 412

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| statusCode | string | HTTP status code (412). |
| errorCode | string | Precondition failed error code identifying the business logic violation. |
| message | string | Error message describing the precondition failed while processing request. |

#### Sample Response: HTTP 412

Non-admin user cannot access the requested computers

```json
{
  "errorCode": "20005",
  "message": "Selected computers are not accessible",
  "statusCode": 412
}
```

Some computers are not managed by the server

```json
{
  "errorCode": "30007",
  "message": "All resources are not managed computers",
  "statusCode": 412
}
```

All agents are already in the target remote office

```json
{
  "errorCode": "30040",
  "message": "All agents are already in the target remote office",
  "statusCode": 412
}
```

### Possible Response Codes

| HTTP Code |
|---|
| 200 |
| 400 |
| 401 |
| 404 |
| 412 |

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.