API keys

API keys authenticate your code with Metrana — most importantly for logging metrics into the portal. Your key is individual: it belongs to you rather than to a workspace, and it acts as you, so it can reach every workspace you’re a member of.

Get your API key

In the portal, open the user menu in the top right corner and choose Get API token to display and copy your token.

Treat it as a long-lived secret

The key doesn’t expire, and there’s currently no way to rotate or revoke it from the portal. Keep it out of source control and out of shared notebooks.

Using a key

Provide the key to the Metrana client library — either as the api_key argument to metrana.init() or, more commonly, via the METRANA_API_KEY environment variable — so your training code can log to your workspaces. For the logging setup itself, see Getting your data in.