Endpoints
List transcriptions
Authorization
apiKey AuthorizationBearer <token>
An API key from Settings → API. Send as Authorization: Bearer vtt_….
In: header
Query Parameters
page?integer
perPage?integer
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/transcriptions"{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "fileName": "string", "status": "pending", "durationSeconds": 0, "language": "string", "mediaType": "string", "createdAt": "2019-08-24T14:15:22Z" } ], "total": 0}{ "error": { "code": "unauthorized", "message": "string" }}{ "error": { "code": "unauthorized", "message": "string" }}Create a signed upload URL POST
Returns a short-lived signed URL. PUT your file bytes to it, then create a transcription with the returned `path` as `storagePath`.
Create a transcription POST
Submit by `storagePath` (from /uploads) or by a public `url` that we fetch directly. Returns immediately with a job id; the job runs asynchronously. Send an optional `Idempotency-Key` header so a retried call returns the same job instead of duplicating it.