The Kairos REST API provides programmatic access to your team's data. All endpoints return JSON responses and require authentication via API key.
https://gateway.thekairos.app/v1All API endpoints are relative to this base URL. For example, to list tasks:
GET https://gateway.thekairos.app/v1/tasksAll requests must include your API key in the Authorization header:
curl -X GET "https://gateway.thekairos.app/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY"All successful responses follow a consistent format:
{
"data": { ... },
"pagination": {
"page": 1,
"limit": 50,
"total": 243,
"has_more": true
}
}The pagination object is included for list endpoints. Single resource endpoints only return the data object.
Errors return an appropriate HTTP status code with a JSON body:
{
"error": {
"code": "validation_error",
"message": "title is required",
"request_id": "req_abc123xyz"
}
}| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | validation_error | Invalid request parameters |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | Insufficient scope for this action |
| 404 | not_found | Resource not found |
| 429 | rate_limit_exceeded | Too many requests |
| 500 | internal_error | Server error |
API requests are rate limited based on your plan. Rate limit headers are included in every response:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704067200When you exceed the rate limit, you'll receive a 429 Too Many Requests response. Wait until the reset time before making more requests.