API Reference

Build anything. Connect everything.

A complete REST API for every KAIRO capability. Versioned, stable, and designed for production.

API is operational — 99.97% uptime last 30 days. View status →

Base URL

https://api.kairo.dev/v1

All endpoints are HTTPS only. HTTP requests are rejected.

Authentication

Authorization: Bearer YOUR_API_KEY

Generate API keys in Settings → API Keys. Keys are prefixed sk_live_ for production.

Endpoint categories

Agents

12 endpoints

Create, configure, and manage AI agents. Set models, attach context sources, define tools.

POST GET PATCH DELETE

Workflows

8 endpoints

Build and execute multi-step automations. Chain agents, define branching logic, schedule runs.

POST GET PUT DELETE

Context

9 endpoints

Manage data sources and context windows. Ingest documents, query embeddings, refresh live data.

POST GET PATCH

Analytics

6 endpoints

Usage metrics, cost reports, and traces. Inspect every agent run, token count, and latency breakdown.

GET

Quick example

Create an agent
in one request

A single POST to /agents spins up a fully configured agent with model routing, context sources, and a unique ID ready to execute workflows.

Agent is active immediately — no provisioning delay
Model set to "auto" routes to best model for each task
Context array attaches your data sources on creation

Request

curl -X POST https://api.kairo.dev/v1/agents \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Lead Qualifier",
  "model": "auto",
  "context": ["crm"]
}'

Response — 201 Created

{
  "id": "agent_01j9k8m3x",
  "name": "Lead Qualifier",
  "status": "active",
  "created_at": "2026-01-15T10:30:00Z"
}

Rate limits

Limits by plan

Plan	Requests / min	Burst cap	Concurrent runs
Free	100 req/min	200	5
Pro	1,000 req/min	2,000	25
Enterprise	Unlimited	Unlimited	Unlimited

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Official SDKs

Type-safe clients for the languages you already use.

TypeScript / Node.js

npm install @kairo/sdk

Full TypeScript types, tree-shakeable, works in Node.js and edge runtimes.

Python

pip install kairo-sdk

Async-first with Pydantic models. Supports Python 3.10+.