# Maybloc API

> Speech-to-text for recorded audio. Upload a recording and get back a transcript with every speaker separated, overlapping speech kept, and every word timed.

## Docs
- [Integration guide](https://app.maybloc.com/llms-full.txt): the whole flow, auth, results, webhooks and errors in one page
- [OpenAPI 3.1](https://app.maybloc.com/openapi.json): every endpoint and field
- [API reference](https://app.maybloc.com/docs): the same, for people

## Operations (base https://app.maybloc.com/api/v1)
- GET /account: Retrieve the account
- POST /uploads: Create an upload
- POST /uploads/{id}/complete: Complete an upload
- GET /transcripts: List transcripts
- POST /transcripts: Create a transcript
- GET /transcripts/{id}: Retrieve a transcript
- PATCH /transcripts/{id}: Rename a transcript or its speakers
- DELETE /transcripts/{id}: Delete a transcript
- GET /transcripts/{id}/result: Retrieve the result
- GET /transcripts/{id}/export: Export subtitles or text
- POST /transcripts/{id}/addons: Add add-ons
- POST /transcripts/{id}/cancel: Cancel a transcript

## Authentication
Authorization: Bearer mbk_live_... (create keys at https://app.maybloc.com/developers/keys)