---
title: "Delete a block"
method: DELETE
path: "/blocks/{id}"
tags: ["Blocks"]
---

# Delete a block

`DELETE /blocks/{id}`

## Request

- Base URL: `https://api5.optimove.net/content/v1`
- URL: `https://api5.optimove.net/content/v1/blocks/{id}`
- Auth: API key in header `X-API-KEY`

Deletes a block. A block that is used in templates can't be deleted: the response lists those templates.
Only the tenant that created a block can delete it. Deleting a block that doesn't exist also returns `204`.

## Response `204`

The block was deleted, or didn't exist.

## Other responses

- `401`: The `X-API-KEY` header is missing or the API key is not valid.
- `403`: The API key doesn't have the admin role, or the tenant isn't allowed to change this item.
- `422`: The content can't be saved (see the create operation), or templates use the block. In the second case, `data` lists those templates.
- `429`: The tenant's rate limit is reached. Retry after the time in `x-ratelimit-reset`.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/optimove/apis/content-api.md) - [All operations](https://skmtc.dev/optimove/apis/content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/content-api/revisions/2f4f55f36f0e?raw)