API Reference

The Conduet API allows you to programmatically interact with your AI agents. Use it to send messages, manage knowledge bases, retrieve analytics, and control conversation state.

Authentication

All API requests require an API key passed in the Authorization header. Generate keys from Project Settings → API keys. Keys use the cdt_ prefix.

curl -X POST /api/v1/conversations/user_123/interact \
  -H "Authorization: Bearer cdt_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"action": {"type": "text", "payload": "Hello!"}}'

Base URL

All endpoints are relative to your deployment's base URL:

https://your-domain.com/api/v1

Rate Limits

Conversation interact endpoints are rate-limited per user. Rate limit headers are included in every response:

Header	Description
X-RateLimit-Limit	Max requests per window
X-RateLimit-Remaining	Remaining requests
X-RateLimit-Reset	Window reset timestamp (epoch ms)

APIs

Project Management API

24 endpoints

Create, list, update, and delete projects. Chat with agents, manage workflows, tools, variables, deployments, KB, and API keys. Requires an account-level developer token.

Conversations API

6 endpoints

Send messages, manage user sessions, and control conversation state programmatically.

Knowledge Base API

6 endpoints

Create, search, upload, and manage knowledge base documents and their embeddings.

Analytics API

3 endpoints

Retrieve project analytics, conversation transcripts, and usage data.

Project (public) API

2 endpoints

Read-only endpoints exposed with a project-scoped widget key.

Error Codes

The API returns standard HTTP status codes. Error responses include a JSON body:

{
  "error": "Human-readable error message",
  "code": "ERROR_CODE"
}

Status	Code	Description
400	BAD_REQUEST	Invalid request body or parameters
401	UNAUTHORIZED	Missing or invalid API key
404	NOT_FOUND	Resource not found
429	RATE_LIMITED	Too many requests
500	INTERNAL	Internal server error