API Overview

The Turen API lets you programmatically access your organization’s data — agents, events, sessions, and policies.

Base URL

https://api.turen.dev/api/v1

All API requests (except health check) require authentication via an API key in the X-API-Key header:

curl -H "X-API-Key: sk_live_your_key_here" \
  https://api.turen.dev/api/v1/registered-agents

Create API keys in the dashboard under Settings > API Keys. See Authentication for details.

All responses are JSON. Successful responses return a 2xx status code. Errors return 4xx or 5xx with a JSON body:

{
  "error": "Description of what went wrong"
}

List endpoints return paginated results wrapped in a pagination object:

{
  "data": [...],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 284,
    "has_more": true
  }
}

Use the limit and offset query parameters to page through results.

Code	Meaning
`200`	Success
`201`	Created
`204`	No content (successful update/delete)
`400`	Bad request — check your parameters
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — valid key but insufficient permissions
`404`	Not found
`429`	Rate limited — slow down
`500`	Internal server error

API requests are rate limited per organization. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1708300000
Retry-After: 1

Group	Description
Authentication	API key management and auth details
Agents	List and manage registered agents
Events	Query security and LLM events
Sessions	List and retrieve session recordings
Policies	Read and update security policies