API keys
Create an API key under Account → Integrations and call the NevTan Cloud public API from scripts, CI, or Zapier.
An API key lets something other than you at the dashboard — a script, a CI pipeline, a tool like Zapier — call NevTan Cloud as you. Create and revoke keys under Account → Integrations.
Create a key
- 1Open Account → IntegrationsIn the API Keys card, click Create Key.
- 2Fill in the formGive it a name, pick Live or Test, and optionally limit it to one project and set an expiry date.
- 3Copy it nowThe full key (
nvt-live-…ornvt-test-…) is shown once. NevTan stores only a hash of it, so it can never be shown again.
| Parameter | Type | Description |
|---|---|---|
namerequired | string | Label shown in the key list. |
environment | "live" | "test" | Decides the key prefix, nvt-live- or nvt-test-. Defaults to live. |
project | string | Limit the key to one project. Calls for any other project are refused with 403. |
expires | date | The key stops working at the end of this day (UTC). |
Call the API
Send the key in the X-API-KEY header (or as Authorization: Bearer <key>) to any /api/v1/public/ endpoint. GET /api/v1/public/me tells you which account and project the key acts for:
| Status | What it means |
|---|---|
| 401 | The key is missing, wrong, revoked, or expired. |
| 403 | The key is limited to another project, or lacks the scope for this action. |
| 429 | More than 120 requests in a minute with this key. Wait for the Retry-After seconds. |
Limits
- Up to 10 active keys per account. Revoke one to create another.
- Last used in the key list updates at most once a minute.
- A key can't create, list, or revoke keys — that always needs you signed in to the console.
- The same key also works with the AI Gateway.
Important
Revoking a key takes effect immediately: the next call with it gets 401. Put a replacement in place first if this is a planned rotation.