# Request Podcast Transcription

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Transcriptions
> Source: https://www.podengine.ai/api-docs/request-podcast-transcription.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/request-podcast-transcription
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/podcasts/:podcastId/transcription-request
**Request Podcast Transcription**

Request multiple episodes for a Podcast to be transcribed and optionally the future Podcast episodes to be transcribed automatically.

```bash
curl -X GET "http://localhost:4000/api/v1/podcasts/:podcastId/transcription-request?type=since&requestFutureEpisodes=false" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "podcastId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Podengine ID"
    }
  },
  "required": [
    "podcastId"
  ],
  "additionalProperties": false
}
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "since",
        "latest",
        "recent"
      ]
    },
    "requestFutureEpisodes": {
      "default": false,
      "description": "If true, future episodes will be transcribed automatically.",
      "type": "boolean"
    }
  },
  "required": [
    "type",
    "requestFutureEpisodes"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "episodeIds": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The IDs of the episodes that were requested."
        }
      },
      "required": [
        "message",
        "episodeIds"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai