> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Placement

> Remove a placement; its slots collapse

Deletes a [placement](https://docs.sequenzy.com/concepts/in-app-placements.md). Your app's slots for this key collapse on their next refresh, and in-app steps that target it skip contacts (with the `placement_not_found` reason in activity) until a placement with the same key exists again. Items already created stay in contact history and never show again, even if you create a placement with the same key later. Requires the `sequences:delete` scope.

## Request

**key** `string` *required*

The placement key.

```bash theme={null}
curl -X DELETE "https://api.sequenzy.com/api/v1/in-app/placements/home_hero" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "key": "home_hero",
  "message": "Placement deleted."
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: sequences:delete"
}
```

```json 404 theme={null}
{
  "error": "Placement \"home_hero\" not found."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.