---
title: "Retry a failed item"
method: POST
path: "/posts/{id}/items/{itemId}/retry"
tags: ["Posts"]
---

# Retry a failed item

`POST /posts/{id}/items/{itemId}/retry`

## Request

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

Re-queues a `failed` item for publishing. Its `error_code` and previous `render_id` are cleared. Only items currently in `failed` state can be retried.

## Path parameters

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

## Response `202`

Response for status 202

- object
  - `id` string, required: The re-queued item.
  - `status` 'pending', required

## Other responses

- `400`: Response for status 400
- `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)