Issue one
1
Open API Keys in Settings
The panel lists every key your firm has issued, each with its scopes and its
status. A revoked key stays listed rather than disappearing, so the record of
what once had access survives.
2
Name it after where it will live
The name is only for you, and its whole job is to make a key identifiable
months later when you are deciding whether it is still needed. “Production
integration” or “Ben’s reporting script” is useful; “API key 2” is not.
3
Choose test or live
Test keys are for building against. Reach for a live key once the thing
you are building is actually running.
4
Select scopes
Each scope grants read access to one kind of data, and the key can do nothing
outside the ones you tick:
Everything the API offers is read-only; there is no scope that writes. Tick
only what the integration needs. A script that charts runway does not need
sources:read, and narrowing the key now limits what a leaked key exposes
later.5
Copy the key immediately
The full key is shown once, at the moment it is created. Vein stores a
hash rather than the key itself, so nobody, including us, can show it to
you again.Copy it into wherever it is going before closing the dialog. If you lose it,
revoke the key and issue another; there is no recovery path.

