---
title: "Delete a post item"
method: DELETE
path: "/posts/{id}/items/{itemId}"
tags: ["Posts"]
---

# Delete a post item

`DELETE /posts/{id}/items/{itemId}`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/posts/{id}/items/{itemId}`
- Auth: API key in header `X-Api-Key`

Cancels a single `pending`, `rendering` or `failed` item so it never publishes. A `rendering` item also aborts its render job when no other item still needs it. An item already `completed` is deleted from the destination network first, and only on networks that allow it. The network's refusal comes back as a `400` and nothing changes here. An item in `publishing` cannot be cancelled: the media is already on its way.

Cancelled items stop appearing in listings, and CutPro keeps the record. When nothing of the parent post is left, `post_deleted: true` is returned.

## Path parameters

- `id` string, required
- `itemId` string, required

## Response `200`

Response for status 200

- object
  - `id` string, required: The removed item.
  - `post_deleted` boolean, required: `true` when that was the last item and the whole post is now cancelled.

## Other responses

- `400`: Response for status 400
- `403`: Response for status 403
- `404`: Response for status 404

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)