# Delete a remote office

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

## Endpoints

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

## Request URL

`https://{server-hostname}:8383/dcapi/som/remote-offices/{remote_office_id}`

## Scope

`SOM.DELETE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` (Mandatory): `application/remoteOfficeDeletedStatus.v1+json`

### Path Parameters

- **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/onpremise/remote-offices-getremoteoffices.html) response.

### Sample Request

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

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

`JSON Object`

- **status** `boolean`: true if the remote office was deleted successfully

### HTTP Code 400

Response Body: `application/json`

`JSON Object`

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

`JSON Object`

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

`JSON Object`

- **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
}
```

## API 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.