Verbafy

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

StatusDescription
200Reservation or duplicate
400Validation or domain request error
401Missing or invalid Clerk Bearer token or guest session
402Plan or usage does not include this action
409Conflict with current resource state

Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.