---
title: "Retry a failed or stalled table-read audio finalize in place."
method: POST
path: "/artifacts/{artifactId}/finalize/retry"
tags: ["Artifacts"]
---

# Retry a failed or stalled table-read audio finalize in place.

`POST /artifacts/{artifactId}/finalize/retry`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/artifacts/{artifactId}/finalize/retry`
- Auth: HTTP bearer

Reuses the existing artifact, media revision, and idempotent credit key; it never regenerates the screenplay or performance. Valid only when `manifest.audio.finalize.status` is `failed` or `stalled` (a render that stopped with nothing working on it). Requires `Idempotency-Key` and `artifact:publish`.

## Headers

- `Idempotency-Key` string, required

## Response `200`

Finalize retry accepted.

- ArtifactFinalizeAck
  - `artifactId` string, required
  - `mode` 'audio', required
  - `finalize` object, required
    - `status` 'queued' | 'synthesizing' | 'stitching' | 'rendering' | 'uploading' | 'complete', required
    - `recordingUrl` string, uri

## Other responses

- `400`: Request payload failed validation. The error message names the offending field.
- `401`: Missing, malformed, revoked, or expired API key.
- `402`: Not enough Studio Credits to reserve this job (`insufficient_credits`), and nothing was reserved. `details` is InsufficientCreditsDetails: `required` and `available`, and `autoTopup` when auto top-up is on but did not cover it — `pending` (retry in a moment), `over_cap` (raise the monthly spending cap), `too_small` (buy a bigger pack) or `failed`.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `404`: The story artifact does not exist or is owned by another account.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/4534f5d25540?raw)