← All docs

Start

Authentication

Every request carries a bearer key. A key belongs to one workspace and can be rotated without downtime.

Send the key in the Authorization header as a bearer token. Requests without it, or with a revoked key, are answered with 401 and read nothing.

Rotating a key

Create the new key, deploy it, then revoke the old one. Both keys work until you revoke, so there is no gap.

Where keys never go

Not in a browser, not in a mobile app, not in a repository. Call Tolva from your server and pass the result on.

Header

Authorization: Bearer $TOLVA_KEY