Create a transcript from a public URL
Accepts a YouTube or Spotify episode URL. Returns 200 when the enhanced transcript is ready, or 202 while processing.
POST /api/v1/transcripts
OpenAPI operation createTranscript. 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, and call Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md. Machine-readable contract: OpenAPI.
Request example
curl -X POST 'https://verbafy.io/api/v1/transcripts' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Responses
| Status | Description |
|---|---|
200 | Transcript ready |
202 | Transcript accepted and still processing |
400 | Validation or domain request error |
401 | Missing or invalid Clerk Bearer token or guest session |
402 | Plan or usage does not include this action |
502 | Upstream processing failed |
503 | Dependency unavailable |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Update preferences
Partial update. Clearing translation language keeps the original language. PATCH /api/v1/me/preferences on the Verbafy REST API.
Delete one transcript
Deletes the transcript. Related private media is removed with its last transcript. DELETE /api/v1/transcripts/{id} on the Verbafy REST API.