Kaiten API

JSON API version: 1

Base URL: https://<your_domain>.kaiten.ru/api/v1

Latest API version is always available at https://<your_domain>.kaiten.ru/api/latest

All requests must contain bearer auth header.

Authorization: Bearer <token>

Example:

Authorization: Bearer 296a5709-99bc-49a7-96e0-c0a1b236091f

Company domain

.kaiten.ru

Get bearer token

API consumes and produces application/json.

API client identification

Integrations may identify themselves with the following optional request headers. They do not replace the Authorization header and must not contain tokens or other secrets.

X-kaiten-Client: kaiten-mcp | kaiten-bridge | kaiten-cli

X-kaiten-Client-Version: <client_version>

The client-name prefix is derived from the configured PROJECT_NAME and normalized for use in HTTP. The allowed suffixes are fixed. Use kaiten-mcp for the MCP integration, kaiten-bridge for HTTP-bridge integrations, and kaiten-cli for the CLI. The version should be a short build or semantic-version identifier.

API Rate Limits

To keep the load on our servers, API rate limits apply. In order to properly configure your API client consider the following response headers:

X-RateLimit-Remaining — remaining number of requests until limit will be reached.
X-RateLimit-Reset — UTC epoch when the limit will be reset

Current limit: 50 requests per second.

If the limit is reached, Kaiten will return 429 HTTP code.

Kaiten