api · v1

REST API · stable.

JSON over HTTPS. Bearer auth. Streaming via SSE. Versioned at the URL. Every breaking change gets a new major version with a 12-month deprecation window.

authentication

Bearer token, simple.

curl https://api.kolayvibe.com/v1/completions \
  -H "Authorization: Bearer sk-kv-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{ "role": "user", "content": "Hello" }],
    "stream": true
  }'

endpoints · v1

All 10 endpoints.

POST /v1/completions Chat-style completions with streaming. The bread and butter. POST /v1/skills/{id}/run Invoke a stored skill with parameters. GET /v1/skills List skills in the current workspace. POST /v1/embeddings Multi-provider embeddings with automatic provider routing. POST /v1/vector/search Query your vector index. Hybrid (BM25 + dense) by default. POST /v1/threads Create a thread (stateful conversation). GET /v1/threads/{id} Fetch a thread with all messages. POST /v1/files Upload a file for attachment to a thread or skill. GET /v1/usage KolayMiles consumption by skill, model, day. POST /v1/webhooks Register a webhook endpoint.

rate limits

Limits by plan.

free

60 req / min

10K tokens / min

pro

600 req / min

200K tokens / min

enterprise

Custom

Negotiated per workload