Skip to main content

​
API Keys

The Turen API uses API keys for authentication. Include your key in the X-API-Key header with every request: 
curl -H "X-API-Key: sk_live_your_key_here" \
  https://api.turen.dev/api/v1/registered-agents
API keys use the prefix sk_live_ and are scoped to a single organization. All data returned is filtered to your organization.

​
Creating an API Key

  1. Log in to the Turen dashboard
  2. Go to Settings > API Keys
  3. Click Create API Key
  4. Copy the key immediately — it’s only shown once

​
Key Types

Turen uses three credential types. Only API keys are used for the dashboard API:
TypePrefixUsage
API Keysk_live_Dashboard API access (this documentation)
Registration Keyrk_live_Agent registration (not used for API)
Agent Secretas_live_Agent-to-platform communication (not used for API)

​
Security Best Practices

  • Store keys in environment variables or a secrets manager, never in source code
  • Use one key per integration so you can revoke individually
  • Rotate keys regularly — create a new key, update your integration, then revoke the old one
  • Monitor key usage in Settings > API Keys (last-used timestamps)
  • Revoke unused keys promptly

​
Health Check

The health endpoint does not require authentication: 
curl https://api.turen.dev/api/v1/health

{
  "status": "ok",
  "timestamp": "2026-02-17T10:30:00Z",
  "version": "0.1.0",
  "database": "connected"
}