---
title: "Delete placement"
type: reference
method: POST
path: /rest-api/placements/{placementId}/delete.do
tag: "Placements"
---

# Delete placement

`POST https://YOUR-NETWORK-DOMAIN/rest-api/placements/{placementId}/delete.do`

Soft-deletes the placement with the given ID. The requester must have DELETE permission on the parent site's inventory through ALL or SHARED level permissions. Once deleted, the placement is marked as removed and its associated banners are unlinked. Returns success:false with permission_denied if the user lacks sufficient privileges.For 90 days POST /rest-api/deleted-entities/PLACEMENT/{id}/restore brings it back, links included.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Unique numeric ID of the placement to delete |

## Responses

- `200` — Placement deleted successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Forbidden — insufficient permissions
- `404` — No placement with this id, or it is already deleted

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/delete.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/placements/post-placements-delete