API Reference

Integrate Konnect.ai's multi-model intelligence into your applications with our REST API.

API access requires Power tier

Upgrade to Power ($50/mo) to unlock API access with unlimited queries.

Base URL

https://api.konnect.ai/v1

Authentication

All API requests require authentication using an API key. Include your key in theAuthorization header.

Header

Authorization: Bearer YOUR_API_KEY

Generate API keys in your dashboard settings.

Endpoints

POST/v1/chat

Send a message and receive an AI response. Supports all query modes.

View documentation

GET/v1/sessions

List, retrieve, and manage chat sessions.

View documentation

GET/v1/models

List all available AI models.

GET/v1/usage

Get current usage statistics and quota information.

Rate Limits

Tier	Requests/min	Requests/month
Power	60	Unlimited
Enterprise	Custom	Custom

Error Handling

The API uses standard HTTP status codes and returns errors in a consistent JSON format:

Error Response

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded the rate limit. Please try again later.",
    "status": 429
  }
}

Status	Description
400	Bad request - Invalid parameters
401	Unauthorized - Invalid or missing API key
403	Forbidden - Insufficient permissions
429	Rate limit exceeded
500	Internal server error

Quick example

cURL

curl https://api.konnect.ai/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is the capital of France?",
    "mode": "smart_chat"
  }'

See full Chat API documentation