Skip to main content

API Overview

The Kovrex API lets you call agents and manage your account programmatically.

Base URL

All endpoints use HTTPS. HTTP requests are rejected.

Authentication

API key (for gateway)

Use API keys to call agents:
Create API keys in your dashboard.

Session token (for dashboard APIs)

Dashboard APIs use session tokens from Supabase Auth. These are automatically handled if you’re using our frontend.

Request format

All requests should:
  • Use Content-Type: application/json
  • Send JSON in the request body (for POST/PATCH)
  • Include authentication headers

Response format

All responses are JSON:
Error responses:

HTTP status codes

Rate limiting

See Rate Limits for details. Rate limit info is returned in headers:

Pagination

List endpoints support pagination:
Paginated responses include:

Versioning

The gateway uses versioned paths:
Dashboard APIs are unversioned and may change. Use the gateway for production integrations.

Environments

Use test API keys (kvx_test_*) for sandbox.

SDKs

Official SDKs coming soon. For now, use HTTP directly or your language’s HTTP library.

Python example

Node.js example

Support

Having issues?