---
title: "DELETE /workspaces/{workspaceId}/entities/{entityId}"
method: DELETE
path: "/workspaces/{workspaceId}/entities/{entityId}"
---

# DELETE /workspaces/{workspaceId}/entities/{entityId}

`DELETE /workspaces/{workspaceId}/entities/{entityId}`

Deletes an entity.

## Path parameters

- `workspaceId` string, required
- `entityId` string, required

## Query parameters

- `isRecursive` boolean

## Response `200`

Success

- DeleteEntityResponse
  - `state` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'ERROR', required — The current state of the deleted entity.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/iottwinmaker.md) · [All operations](https://skmtc.net/aws/apis/iottwinmaker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iottwinmaker/versions/a66a26fd65ea/schema)