Konvoq API Reference

Powerful APIs to integrate AI conversations anywhere. RESTful, predictable, and production-ready.

Base URLhttps://api.konvoq.com/v1

API Endpoint Categories

Chatbots

Create, update, delete, and configure chatbot instances. Set personalities, training data, and deployment targets.

GETPOSTPUTDELETE

8 endpoints '

Conversations

Query conversation history, export transcripts, access analytics, and filter by date, resolution status, or CSAT score.

GETPOST

6 endpoints '

Messages

Send messages programmatically, retrieve thread history, inject context into ongoing conversations in real time.

GETPOST

5 endpoints '

Webhooks

Subscribe to real-time event notifications new conversations, resolved tickets, escalations, and CSAT submissions.

GETPOSTDELETE

4 endpoints '

Create a chatbot in one request

curl -X POST https://api.konvoq.com/v1/chatbots \
  -H "Authorization: Bearer kq_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Bot",
    "model": "gpt-4o",
    "persona": "Friendly and professional",
    "knowledge_base_ids": ["kb_abc123"],
    "languages": ["en", "es", "fr"],
    "fallback_email": "support@yourcompany.com"
  }'

API Key Authentication

All API requests must include your API key as a Bearer token in the Authorization header. Keys are prefixed with kq_live_ for production and kq_test_ for sandbox.

Authorization: Bearer kq_live_xxxxxxxxxxxx

Requests Per Plan

Free

100 / hr

3,000 / mo

Pro

10,000 / hr

720,000 / mo

Business

Unlimited

Official SDKs

Type-safe, well-documented, and production-ready.

JavaScript / TypeScript

Official SDK

npm install @konvoq/sdk

Python

Official SDK

pip install konvoq

Official SDK

go get github.com/konvoq/konvoq-go

Ready to integrate?

Get your API key from the dashboard and make your first request in under 60 seconds.

Get API Key 'View Docs

curl -X POST https://api.konvoq.com/v1/chatbots \ -H "Authorization: Bearer kq_live_xxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "name": "Support Bot", "model": "gpt-4o", "persona": "Friendly and professional", "knowledge_base_ids": ["kb_abc123"], "languages": ["en", "es", "fr"], "fallback_email": "support@yourcompany.com" }'