---
title: "Soft delete an entity"
method: POST
path: "/api/entities/{id}/lifecycle/softdeleteentity"
tags: ["Lifecycle"]
---

# Soft delete an entity

`POST /api/entities/{id}/lifecycle/softdeleteentity`

## Request

- Base URL: `https://your-server`
- URL: `https://your-server/api/entities/{id}/lifecycle/softdeleteentity`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/sitecore/apis/entities-api/docs/api/entities/:id/lifecycle/softdeleteentity/post.ts> (a function with typed inputs; its response is checked against the schema)

Deletes an entity, marking it as deleted but without permanently removing it from the system (soft deletion). This action can be reversed by restoring the entity later. Requires the <i>Delete</i> permission.

## Path parameters

- `id` integer, required

## Response `200`

Entity soft deleted successfully

## Other responses

- `400`: Request not valid
- `401`: Unauthorized request
- `403`: Insufficient permission
- `404`: Entity not found or user not authorized

---

[API](https://skmtc.dev/sitecore/apis/entities-api.md) - [All operations](https://skmtc.dev/sitecore/apis/entities-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sitecore/apis/entities-api/revisions/328bbdd51028?raw)