# Delete a remote office

Deletes a remote office (branch office) identified by ID.

## Endpoint

`DELETE /dcapi/som/remote-offices/{remote_office_id}`

## Request URL

`https://{serverurl}/dcapi/som/remote-offices/{remote_office_id}`

## Scope

`DesktopCentralCloud.SOM.DELETE`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/remoteOfficeDeletedStatus.v1+json` |

### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| remote_office_id | string | Mandatory | Unique identifier for the remote office. Get the remote office ID from the `resource_id` field in the [Get Remote Offices](https://www.manageengine.com/products/desktop-central/help/api/cloud/remote-offices-getremoteoffices.html) response. |

## Sample Request

```curl
curl --request DELETE \
  --url https://appdomains/dcapi/som/remote-offices/{remote_office_id} \
  --header 'Accept: application/remoteOfficeDeletedStatus.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| status | boolean | `true` if the remote office was deleted successfully |

### HTTP Code 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 |

### HTTP Code 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 |

### HTTP Code 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 |

## Possible Response Codes

- `200` HTTP code
- `400` HTTP code
- `404` HTTP code
- `412` HTTP code

## Sample Responses

### HTTP 200

Remote office deleted

```json
{
  "status": true
}
```

### HTTP 400

Cannot delete the local office

```json
{
  "errorCode": "30059",
  "message": "Local office cannot be deleted",
  "statusCode": 400
}
```

### HTTP 404

Remote office not found

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

### HTTP 412

Remote office is mapped with SoM policy targets

```json
{
  "errorCode": "30066",
  "message": "Remote office cannot be removed as it is mapped with SoM policy targets",
  "statusCode": 412
}
```

Remote office is configured as AD connector branch

```json
{
  "errorCode": "30044",
  "message": "Remote office configured as AD connector branch cannot be deleted",
  "statusCode": 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.