SDK and Code Samples

# TypeScript types
npx openapi-typescript https://your-domain.com/api/v1/openapi.json -o api.d.ts

# Python client
openapi-generator generate -i https://your-domain.com/api/v1/openapi.json -g python -o ./client

export CLOUISLE_API_KEY="clou_your_full_key_here"
curl -X GET "https://your-domain.com/api/v1/agents" \
  -H "Authorization: Bearer $CLOUISLE_API_KEY"

const API_BASE = 'https://your-domain.com/api/v1';
const headers = {
  Authorization: `Bearer ${process.env.CLOUISLE_API_KEY}`,
  'Content-Type': 'application/json',
};

// List Agents (pagination envelope, see ./conventions)
const listRes = await fetch(`${API_BASE}/agents?page=1&page_size=20`, { headers });
const listBody = await listRes.json();
if (listBody.code !== 0) throw new Error(listBody.msg);
for (const agent of listBody.data.items) console.log(agent.id, agent.name);

// Run a workflow (async: returns run_id + stream_url)
const runRes = await fetch(`${API_BASE}/workflows/${workflowId}/run`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ inputs: { customer_email: 'customer@example.com' } }),
});
const runBody = await runRes.json();
console.log(runBody.data.run_id, runBody.data.stream_url);

import os
import requests

API_BASE = "https://your-domain.com/api/v1"
headers = {"Authorization": f"Bearer {os.getenv('CLOUISLE_API_KEY')}"}

# Log in for a JWT (form-encoded)
login = requests.post(
    f"{API_BASE}/login/access-token",
    data={"username": "your_username", "password": "your_password"},
).json()
token = login["data"]["access_token"]

# Chat (conversations are created implicitly; pass conversation_id to continue one)
chat = requests.post(
    f"{API_BASE}/agents/{agent_id}/chat",
    headers={"Authorization": f"Bearer {token}"},
    json={"message": "Hello! I need help with my order.", "conversation_id": None, "variables": {}},
).json()
print(chat["data"]["conversation_id"], chat["data"]["message"]["content"])

# Search a knowledge base
search = requests.post(
    f"{API_BASE}/knowledge-bases/{kb_id}/search",
    headers=headers,
    json={"query": "How to reset password?", "search_mode": "hybrid", "top_k": 5},
).json()
for item in search["data"]["results"]:
    print(item["document_name"], item["score"])

const response = await fetch(
  `https://your-domain.com/api/v1/agents/${agentId}/chat/stream`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
      Accept: 'text/event-stream',
    },
    body: JSON.stringify({ message: 'Tell me a story', conversation_id: null, variables: {} }),
  }
);

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = '';
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split('\n');
  buffer = lines.pop() || '';
  let eventType = '';
  for (const line of lines) {
    if (line.startsWith('event: ')) eventType = line.slice(7);
    else if (line.startsWith('data: ') && eventType) {
      const data = JSON.parse(line.slice(6));
      if (eventType === 'content_delta') process.stdout.write(data.delta);
      if (eventType === 'message_end') console.log('\n[Done]');
      eventType = '';
    }
  }
}

result = requests.post(
    f"{API_BASE}/agents",
    headers={"Authorization": f"Bearer {token}"},
    json={"name": "x"},  # missing required team_id
).json()

if result["code"] != 0:
    if result["code"] == 1001:
        for field, messages in result["data"]["errors"].items():
            print(f"{field}: {', '.join(messages)}")
    else:
        print(f"Error {result['code']}: {result['msg']}")