Manage API keys
Create, scope, rotate, and revoke the keys that authenticate your requests.
Key types
| Prefix | Environment | Counts against quota? |
|---|---|---|
vx-live- | Production | Yes |
vx-test- | Sandbox / development | No |
The SDK validates the prefix and rejects keys that use underscores. The format is
vx-live- with dashes, not vx_live_.Creating a key
1
Open Settings → API Keys in the dashboard.
2
Click Create key, give it a descriptive name (e.g. prod-backend), and choose the environment.
3
Copy the key immediately — only a short prefix is stored and shown afterward.
Using a key
Pass it to the SDK, or send it as a bearer token over REST. Prefer environment variables over hard-coding.
PythonREST
import veldrixai, os
# Reads VELDRIX_API_KEY from the environment
client = veldrixai.Veldrix.from_env()
# or explicitly:
client = veldrixai.Veldrix(api_key=os.environ["VELDRIX_API_KEY"])
Rotating & revoking
Rotate keys on a schedule and whenever a key may have been exposed. Create the new key, deploy it, then revoke the old one from the dashboard — revocation takes effect immediately. Each key shows a last-used timestamp to help you spot stale credentials.
Security best practices
- Use a dedicated key per service so you can revoke narrowly.
- Never expose
vx-live-keys in browser/client-side code — call VeldrixAI from your backend. - Store keys in a secret manager (AWS Secrets Manager, Vault, Doppler), not in
.envcommitted to git.
Was this page helpful?