---
title: "Regenerate a failed job piece"
method: POST
path: "/content/pieces/{pieceId}/regenerate"
tags: ["Content"]
---

# Regenerate a failed job piece

`POST /content/pieces/{pieceId}/regenerate`

## Request

- Base URL: `https://app.getprolifik.com/api/v1`
- URL: `https://app.getprolifik.com/api/v1/content/pieces/{pieceId}/regenerate`
- Auth: HTTP bearer

Replaces a failed piece produced by a content job with a freshly written script and new library assets. Use /retry to re-render the existing script instead.

## Path parameters

- `pieceId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Response `202`

Regeneration queued

- object

## Other responses

- `400`: Request failed
- `401`: Request failed
- `402`: Payment required. error.code is subscription_required (the plan does not include this feature, or the key's account no longer has a plan: API keys are paid-only, so every write from a key whose account has none is refused; see error.upgradeUrl), insufficient_credits (the AI-credit balance is short; see error.needed, error.balance, error.upgradeUrl), or quota_exceeded (a plan quota such as monthly videos or clip minutes).
- `403`: Request failed
- `404`: Request failed
- `409`: Request failed
- `429`: Request failed
- `503`: Request failed

---

[API](https://skmtc.dev/getprolifik/apis/prolifik-public-api.md) · [All operations](https://skmtc.dev/getprolifik/apis/prolifik-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getprolifik/apis/prolifik-public-api/revisions/301e79c5763c?raw)