---
title: "Retry a failed transcript"
description: "Re-queues processing. Status may be 204, 202, or 200 depending on current state. POST /api/v1/transcripts/{id}/retry on the Verbafy REST API."
canonical: "https://verbafy.io/docs/api/transcripts/retry-transcript"
last-updated: "2026-10-04"
---

# Retry a failed transcript

Re-queues processing. Status may be 204, 202, or 200 depending on current state.

`POST /api/v1/transcripts/{id}/retry`

OpenAPI operation `retryTranscript`. Authenticate with a Clerk session JWT (`Authorization: Bearer {jwt}`) or the `verbafy_guest_session` cookie. `{jwt}` is a Clerk session token after you sign in on the website. Verbafy does not issue that token and does not show it in Settings. For scripts and agents, sign in, create an API key at [Settings → API keys](/app/settings/api-keys), and call Remote MCP with `Authorization: Bearer sk-…`. Credential setup: [Auth.md](/auth.md). Machine-readable contract: [OpenAPI](/openapi.json).

## Parameters

| Name | Location | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | Yes | string / uuid | Transcript UUID owned by the current account |

## curl

```curl
curl -X POST 'https://verbafy.io/api/v1/transcripts/{id}/retry' \
  -H 'Authorization: Bearer {jwt}'
```

## JavaScript

```javascript
const response = await fetch('https://verbafy.io/api/v1/transcripts/{id}/retry', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {jwt}',
  }
});
```

## Python

```python
import httpx

response = httpx.post(
    "https://verbafy.io/api/v1/transcripts/{id}/retry",
    headers={"Authorization":"Bearer {jwt}"},
)
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Already ready |
| `202` | Retry accepted |
| `204` | No content retry accepted |
| `401` | Missing or invalid Clerk Bearer token or guest session |
| `402` | Plan or usage does not include this action |
| `404` | Resource not found for the current account |

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://verbafy.io/#organization",
      "name": "Verbafy",
      "url": "https://verbafy.io",
      "logo": {
        "@type": "ImageObject",
        "url": "https://verbafy.io/opengraph-image.png"
      },
      "knowsAbout": [
        "YouTube transcription",
        "Spotify episode transcription",
        "Meeting recording transcription",
        "Speaker diarization",
        "Transcript export"
      ],
      "hasOfferCatalog": {
        "@type": "OfferCatalog",
        "@id": "https://verbafy.io/pricing#offers"
      },
      "contactPoint": {
        "@type": "ContactPoint",
        "contactType": "customer support",
        "email": "support@verbafy.io",
        "url": "https://verbafy.io/contact"
      }
    },
    {
      "@type": "WebSite",
      "@id": "https://verbafy.io/#website",
      "url": "https://verbafy.io",
      "name": "Verbafy",
      "inLanguage": "en",
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "TechArticle",
      "@id": "https://verbafy.io/docs/api/transcripts/retry-transcript#page",
      "name": "Retry a failed transcript",
      "description": "Re-queues processing. Status may be 204, 202, or 200 depending on current state. POST /api/v1/transcripts/{id}/retry on the Verbafy REST API.",
      "url": "https://verbafy.io/docs/api/transcripts/retry-transcript",
      "image": "https://verbafy.io/opengraph-image.png",
      "datePublished": "2026-09-09",
      "dateModified": "2026-10-04",
      "inLanguage": "en",
      "author": {
        "@type": "Organization",
        "@id": "https://verbafy.io/#organization",
        "name": "Verbafy"
      },
      "isPartOf": {
        "@id": "https://verbafy.io/#website"
      },
      "publisher": {
        "@id": "https://verbafy.io/#organization"
      }
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://verbafy.io"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Retry a failed transcript",
          "item": "https://verbafy.io/docs/api/transcripts/retry-transcript"
        }
      ]
    }
  ]
}
```
