API reference
These pages are generated from OpenAPI. OpenAPI is the HTTP source of truth. Remote MCP at /api/v1/mcp is a companion wrap.
{jwt} in REST examples is a Clerk session token after website login. Verbafy does not issue or display that token. For scripts and agents, sign in, create an API key at Settings → API keys, and use Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md.
Auth
- `POST /api/v1/auth/guest-sessions`: Create or reuse a Guest session
- `DELETE /api/v1/auth/guest-sessions/current`: Revoke the current Guest session
- `POST /api/v1/auth/guest-sessions/claim`: Claim Guest data onto a Registered User
Transcripts
- `POST /api/v1/transcripts`: Create a transcript from a public URL
- `GET /api/v1/transcripts`: List transcripts for the current account
- `GET /api/v1/transcripts/statuses`: Batch-read transcript statuses
- `GET /api/v1/transcripts/{id}`: Get one transcript
- `DELETE /api/v1/transcripts/{id}`: Delete one transcript
- `GET /api/v1/transcripts/{id}/status`: Poll one transcript status
- `GET /api/v1/transcripts/{id}/captions`: Get YouTube caption preview
- `POST /api/v1/transcripts/{id}/retry`: Retry a failed transcript
Chat
- `GET /api/v1/transcripts/{id}/chat`: Get transcript chat
- `POST /api/v1/transcripts/{id}/chat/messages`: Send a chat message
- `PUT /api/v1/transcripts/{id}/chat/messages/{messageId}/rating`: Rate a chat message
Uploads
- `POST /api/v1/transcript-uploads`: Reserve a private multipart upload
- `POST /api/v1/transcript-uploads/{id}/parts`: Sign one multipart part
- `POST /api/v1/transcript-uploads/{id}/complete`: Complete a multipart upload
- `DELETE /api/v1/transcript-uploads/{id}`: Cancel a reservation
Billing
- `GET /api/v1/billing/me`: Get current plan and usage
- `GET /api/v1/billing/catalog`: Get public price catalog
- `GET /api/v1/billing/pricing-context`: Get pricing context
- `POST /api/v1/billing/checkout`: Start a paid plan checkout
- `POST /api/v1/billing/change-plan`: Change the paid plan
- `POST /api/v1/billing/convert-trial`: Convert a paid-plan trial
- `POST /api/v1/billing/portal`: Create a Stripe billing portal session
Preferences
- `GET /api/v1/me/preferences`: Get preferences
- `PATCH /api/v1/me/preferences`: Update preferences
API Keys
- `GET /api/v1/me/api-keys`: List API keys
- `POST /api/v1/me/api-keys`: Create API key
- `DELETE /api/v1/me/api-keys/{id}`: Revoke API key
MCP
- `POST /api/v1/mcp`: Remote MCP Streamable HTTP
- `GET /api/v1/mcp`: Remote MCP Streamable HTTP GET
- `DELETE /api/v1/mcp`: Remote MCP Streamable HTTP DELETE
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.