Authentication
Every request to the Zutrix API is authenticated with an API key sent as a bearer token.
API keys
Keys are created at zutrix.com/dashboard/settings/api and have the prefix zutrix_live_.
- Up to 10 named keys per account — create one key per integration (e.g. "CI reports", "Internal dashboard") so they can be rotated independently.
- Shown once — the full key is displayed only at creation. Store it in a secret manager; if you lose it, create a new key.
- Revocable — revoke a key at any time from the dashboard. Requests with a revoked key fail immediately with
401 UNAUTHORIZED.
Header format
Send the key in the Authorization header on every request:
Header
Authorization: Bearer zutrix_live_xxxxxxxxxxxxxxxxTerminal
curl https://api.zutrix.com/v1/me \
-H "Authorization: Bearer $ZUTRIX_API_KEY"A missing or invalid key returns 401 with code UNAUTHORIZED and a hint pointing at the key settings page.
Security notes
Keep keys server-side
API keys grant access to your whole workspace. Never embed them in browser JavaScript, mobile apps, or public repositories — call the API from your server and keep the key in an environment variable or secret manager.
- Revoke on leak — if a key is exposed (committed to git, pasted in a log, shared in chat), revoke it in the dashboard immediately and create a replacement.
- Rotate periodically — because keys are named and you can hold several, you can add a new key, migrate, then revoke the old one with zero downtime.
- Scope by integration — separate keys per tool make audits and revocation surgical instead of disruptive.