# Changelog

Contract and documentation changes that affect API integrations

Canonical: https://alef-bot.top/en/developers/changelog

Updated: 2026-08-14

## 2026-08-14

- Artifact download documentation now covers SRT, TXT, PDF and DOCX, format selection and returned content types
- The API reference now shows webhook event bodies and all signing headers as a transcription creation callback

## 2026-07-13

- Webhooks are now delivered on transcription completion or failure with an account signing secret and retries
- POST /webhooks/test checks the target and signature without creating a transcription; the target must be public HTTPS on port 443
- Rate limits are now account-based and separate for writes, reads, artifact downloads and webhook tests
- Each upload slot is single-use; source media is deleted automatically after transcription completion
- GET and POST /api/v1/keys were removed; keys are managed in the dashboard and invalid pagination returns 422

## 2026-07-10

- Enriched OpenAPI 3.1 contracts were published in JSON and YAML
- Stable operation IDs, Bearer authentication, response headers and error schemas were added
- Postman files for manual testing and an Arazzo transcription workflow were added
- Stable documentation URLs for every error and a uniform validation error envelope were added

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)