---
updatedAt: 2025-05-27T23:50:06.000Z
agentTools:
  projectIndex: https://developer.corrigo.com/llms.txt
---

# DELETE

Learn how to delete entities

Use the DELETE method to remove an entity from active list.

DELETE **\{Host Name}**/api/v1/base/**\{EntityType}**/**\{ID of Entity}**

where **\{Host Name}** is derived from [GetCompanyWsdkUrlCommand.Url](https://corrigo-enterprise-2022.readme.io/reference/cmd#getcompanywsdkurlcommand), and\
**\{EntityType}** is a class that is derived from [RemovableCorrigoEntity](https://securecontent.corrigo.com/docs/HelpCE97/html/2308e0f0-6af3-5001-735b-438aa5bb1d9b.htm) parent class, and\
**\{ID of Entity}** is the integer value of non-archived Entity within the targeted Company

## Contact Example

**Contacts** are frequently removed from the system as access to Customer Portal is revoked. Note that **RestoreCommand** may be used to reverse this operation.

```http (HTTP) Headers
DELETE https://am-ent-f2b.corrigo.com/api/v1/base/Contact/20378 HTTP/1.1
Accept-Encoding: gzip,deflate
CompanyName: Your Company
Content-Type: application/json
Authorization: Bearer eyJBdXRoZW50aWNhdGlvblR5cGUiOiJCZWFyZXIiLCJOYW1lQ2xhaW1UeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlJvbGVDbGFpbVR5cGUiOiJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIiwiQ2xhaW1zIjpbeyJUeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlZhbHVlIjoiY2VhcGljbGllbnQuMS4xODY4LmQxZWYiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9LHsiVHlwZSI6InVybjpvYXV0aDpzY29wZSIsIlZhbHVlIjoiIiwiVmFsdWVUeXBlIjoiaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEjc3RyaW5nIiwiSXNzdWVyIjoiTE9DQUwgQVVUSE9SSVRZIiwiT3JpZ2luYWxJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkifSx7IlR5cGUiOiJBdWQiLCJWYWx1ZSI6IjE4NjgiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9XSwiUHJvcGVydGllcyI6eyJEaWN0aW9uYXJ5Ijp7Ii5pc3N1ZWQiOiJGcmksIDEwIERlYyAyMDIxIDAwOjIzOjQ0IEdNVCIsIi5leHBpcmVzIjoiRnJpLCAxMCBEZWMgMjAyMSAwMDo0Mzo0NCBHTVQifX19<---->VsnD9Qc5CkNPdakJ2TZ5qQhygiDp59HPJAxVJDZZ4SsTKqPC3D2Fqd_U3CmrT4ULSk0FbE7aZ61dHpYYpJPlRXxwT0Urgv1lZgqwtv0h7ApwqxGALB9UlZTujLF2ASFCmoNYe250TagbVZDfLh1rR5UWpC0usJoiPVfDynL-p-S6rnhLaPqrRiku2kI58zA0NME19da90bV3f2-WFTnr5cNNjs1UFj85xOiQd0xgMcyIoJr4yzJiMBiyr2gTSK4vdQVYPoBRfTQvxtDBbw7els3hlcKbU98gvBeQkQ2eEW18kTdgOyHg77I7UUZ5VFpNiz6R_ORBsUUbfSUW0mAWrg
Content-Length: 0
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.5.2 (Java/16.0.1)
```
```json (JSON) Response
{
   "EntitySpecifier" : {
      "EntityType" : "Contact",
      "Id" : 20378
   }
}
```

## WorkOrder Example

**WorkOrder** entities cannot be deleted from the Corrigo Enterprise application, resulting in an **ERROR\_CODE\_1000** error message if attempted.

```http (HTTP) DELETE WorkOrder
DELETE https://am-ent-f2b.corrigo.com/api/v1/base/WorkOrder/37 HTTP/1.1
Accept-Encoding: gzip,deflate
CompanyName: Your Company
Content-Type: application/json
Authorization: Bearer eyJBdXRoZW50aWNhdGlvblR5cGUiOiJCZWFyZXIiLCJOYW1lQ2xhaW1UeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlJvbGVDbGFpbVR5cGUiOiJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIiwiQ2xhaW1zIjpbeyJUeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlZhbHVlIjoiY2VhcGljbGllbnQuMS4xODY4LmQxZWYiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9LHsiVHlwZSI6InVybjpvYXV0aDpzY29wZSIsIlZhbHVlIjoiIiwiVmFsdWVUeXBlIjoiaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEjc3RyaW5nIiwiSXNzdWVyIjoiTE9DQUwgQVVUSE9SSVRZIiwiT3JpZ2luYWxJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkifSx7IlR5cGUiOiJBdWQiLCJWYWx1ZSI6IjE4NjgiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9XSwiUHJvcGVydGllcyI6eyJEaWN0aW9uYXJ5Ijp7Ii5pc3N1ZWQiOiJGcmksIDEwIERlYyAyMDIxIDAwOjIzOjQ0IEdNVCIsIi5leHBpcmVzIjoiRnJpLCAxMCBEZWMgMjAyMSAwMDo0Mzo0NCBHTVQifX19<---->VsnD9Qc5CkNPdakJ2TZ5qQhygiDp59HPJAxVJDZZ4SsTKqPC3D2Fqd_U3CmrT4ULSk0FbE7aZ61dHpYYpJPlRXxwT0Urgv1lZgqwtv0h7ApwqxGALB9UlZTujLF2ASFCmoNYe250TagbVZDfLh1rR5UWpC0usJoiPVfDynL-p-S6rnhLaPqrRiku2kI58zA0NME19da90bV3f2-WFTnr5cNNjs1UFj85xOiQd0xgMcyIoJr4yzJiMBiyr2gTSK4vdQVYPoBRfTQvxtDBbw7els3hlcKbU98gvBeQkQ2eEW18kTdgOyHg77I7UUZ5VFpNiz6R_ORBsUUbfSUW0mAWrg
Content-Length: 0
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.5.2 (Java/16.0.1)
```
```json (JSON) Response
{
    "ErrorMessage": "Delete operation is not supported by WorkOrder entity.",
    "ErrorCode": "ERROR_CODE_1000",
    "TimeStamp": "2021-12-20T10:17:32.1004117Z"
}
```

## WorkZone Example

Some entities like WorkZone require a special command for deletion, resulting in **CUSTOM\_COMMAND\_ERROR** error message if DELETE is attempted.

```http (HTTP) DELETE Workzone
DELETE https://am-ent-f2b.corrigo.com/api/v1/base/WorkZone/7 HTTP/1.1
Accept-Encoding: gzip,deflate
CompanyName: Your Company
Content-Type: application/json
Authorization: Bearer eyJBdXRoZW50aWNhdGlvblR5cGUiOiJCZWFyZXIiLCJOYW1lQ2xhaW1UeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlJvbGVDbGFpbVR5cGUiOiJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIiwiQ2xhaW1zIjpbeyJUeXBlIjoiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbmFtZSIsIlZhbHVlIjoiY2VhcGljbGllbnQuMS4xODY4LmQxZWYiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9LHsiVHlwZSI6InVybjpvYXV0aDpzY29wZSIsIlZhbHVlIjoiIiwiVmFsdWVUeXBlIjoiaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEjc3RyaW5nIiwiSXNzdWVyIjoiTE9DQUwgQVVUSE9SSVRZIiwiT3JpZ2luYWxJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkifSx7IlR5cGUiOiJBdWQiLCJWYWx1ZSI6IjE4NjgiLCJWYWx1ZVR5cGUiOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSNzdHJpbmciLCJJc3N1ZXIiOiJMT0NBTCBBVVRIT1JJVFkiLCJPcmlnaW5hbElzc3VlciI6IkxPQ0FMIEFVVEhPUklUWSJ9XSwiUHJvcGVydGllcyI6eyJEaWN0aW9uYXJ5Ijp7Ii5pc3N1ZWQiOiJGcmksIDEwIERlYyAyMDIxIDAwOjIzOjQ0IEdNVCIsIi5leHBpcmVzIjoiRnJpLCAxMCBEZWMgMjAyMSAwMDo0Mzo0NCBHTVQifX19<---->VsnD9Qc5CkNPdakJ2TZ5qQhygiDp59HPJAxVJDZZ4SsTKqPC3D2Fqd_U3CmrT4ULSk0FbE7aZ61dHpYYpJPlRXxwT0Urgv1lZgqwtv0h7ApwqxGALB9UlZTujLF2ASFCmoNYe250TagbVZDfLh1rR5UWpC0usJoiPVfDynL-p-S6rnhLaPqrRiku2kI58zA0NME19da90bV3f2-WFTnr5cNNjs1UFj85xOiQd0xgMcyIoJr4yzJiMBiyr2gTSK4vdQVYPoBRfTQvxtDBbw7els3hlcKbU98gvBeQkQ2eEW18kTdgOyHg77I7UUZ5VFpNiz6R_ORBsUUbfSUW0mAWrg
Content-Length: 0
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.5.2 (Java/16.0.1)
```
```json (JSON) Response
{
    "ErrorMessage": "Use custom command for 'WorkZone' for that action.",
    "ErrorCode": "CUSTOM_COMMAND_ERROR",
    "TimeStamp": "2021-12-20T12:55:37.7493052Z"
}
```

## Applying to other EntityTypes

The base **DELETE** operation covers the only those classes derived from **RemovableCorrigoEntity** class.

<Embed url="https://securecontent.corrigo.com/docs/HelpCE97/html/2308e0f0-6af3-5001-735b-438aa5bb1d9b.htm" title="RemovableCorrigoEntity Class" favicon="https://securecontent.corrigo.com/docs/HelpCE97/icons/favicon.ico" provider="securecontent.corrigo.com" href="https://securecontent.corrigo.com/docs/HelpCE97/html/2308e0f0-6af3-5001-735b-438aa5bb1d9b.htm" />

![1395](https://files.readme.io/3bf34ce-Screenshot_2022-02-24_082616.png "Screenshot 2022-02-24 082616.png")