---
title: "deleteEntity"
method: DELETE
path: "/v1/entity/{slug}/{id}"
tags: ["Entities"]
---

# deleteEntity

`DELETE /v1/entity/{slug}/{id}`

Deletes an Entity

## Activity

If no `activity_id` query parameter is provided, implicitly creates Activity of type `EntityDeleted`

## Deletion Mode

All entities are soft deleted by default. To force an actual deletion from the system, provide `purge:true` to delete the entity and all its activity history permanently.

## Path parameters

- `slug` string, required — URL-friendly identifier for the entity schema
- `id` string, uuid, required

## Query parameters

- `activity_id` union
  - string, ulid — See https://github.com/ulid/spec
  - '' | 'null', nullable
- `purge` boolean

## Response `200`

Success

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/epilot/apis/entity-api.md) · [All operations](https://skmtc.net/epilot/apis/entity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/entity-api/versions/8dd3d44e1c4f/schema)
