Skip to main content
API keys allow programmatic access to the Turen dashboard API. Use them for integrations, automation, and scripts.

​
Key Format

API keys use the prefix sk_live_ followed by a random string: 
sk_live_abc123def456...

​
Creating an API Key

1

Go to Settings > API Keys

Open the API keys page in the dashboard.
2

Click Create API Key

Enter a name and optional description for the key.
3

Copy the key

The full key is shown once. Copy it immediately — you won’t be able to see it again.
Store API keys securely. Treat them like passwords — never commit them to source control or share them in plain text.

​
Using an API Key

Include the key in the X-API-Key header: 
curl -H "X-API-Key: sk_live_your_key_here" \
  https://api.turen.dev/api/v1/stats/summary
API keys have the same access as the dashboard — they can query events, agents, sessions, and stats.

​
Managing Keys

From Settings > API Keys, you can:
  • View all keys — See key names, creation dates, status, and last-used timestamps
  • Revoke a key — Disable a key. This takes effect immediately.
  • Delete a key — Permanently remove a revoked key.
Keys can have one of three statuses: active, revoked, or expired.
Revoking a key is immediate. Any integrations using the revoked key will stop working right away.

​
Best Practices

  • Use descriptive names so you know what each key is for
  • Rotate keys regularly — create a new key, update your integrations, then revoke the old one
  • Use one key per integration — this way you can revoke access for a single integration without affecting others
  • Monitor last-used timestamps — keys that haven’t been used recently may be stale and should be revoked