Reserve a private multipart upload
Returns a reservation or an existing transcript when the content hash matches. Clients then sign parts and complete. Do not send storage credentials to browsers.
POST /api/v1/transcript-uploads
OpenAPI operation createTranscriptUpload. 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/transcript-uploads' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"filename":"meeting.m4a","bytes":1048576,"contentSha256":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"}'Responses
| Status | Description |
|---|---|
200 | Reservation or duplicate |
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 |
409 | Conflict with current resource state |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Complete a multipart upload
Validates parts server-side and starts transcription. May return 200 or 202. POST /api/v1/transcript-uploads/{id}/complete on the Verbafy REST API.
Sign one multipart part
Returns a short-lived signed URL for one part number. POST /api/v1/transcript-uploads/{id}/parts on the Verbafy REST API.