Varmirdocs
Docs/Get started/Authentication

Authentication

Every Varmir API call is authenticated with a single Bearer token. No client secrets, no OAuth handshake — just one header you generate in the dashboard.

Get an API key

Open the API keys tab in your dashboard, give the key a name (e.g. Production) and click Create key. The raw value is shown once — store it in your secret manager immediately.

All keys are prefixed with mstk_ so they're easy to grep for in logs.

Authorization header

Send the key as a Bearer token in the Authorization header of every request:

HTTP
Authorization: Bearer mstk_your_key

If your HTTP client can't set Authorization, use the X-API-Key: mstk_your_key header instead. Without a valid key you get 401 invalid_api_key.

Key permissions

Every key can transcribe audio and read /me and /usage. To create, list or revoke keys through the API (/api/v1/keys), the key also needs the keys:write scope. Tick it when you create the key in the dashboard. Without it, those endpoints return 403 forbidden.

Rotation & revocation

Create a new key, deploy it everywhere, then Revoke the old one from the dashboard. Revoked keys start failing with 401 invalid_api_key right away. Their usage history stays in the dashboard.