MOTAI API Reference

const response = await fetch('https://gateway.motai.ai/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'Summarize our last conversation',
    user_external_id: 'user-123',
  }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const chunk = decoder.decode(value);
  // parse SSE lines
  chunk.split('\n').forEach(line => {
    if (!line.startsWith('data: ')) return;
    const raw = line.slice(6);
    if (raw === '[DONE]') return;
    const data = JSON.parse(raw);
    process.stdout.write(data.choices[0]?.delta?.content ?? '');
  });
}

import requests
import json

response = requests.post(
    "https://gateway.motai.ai/v1/chat",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "message": "Summarize our last conversation",
        "user_external_id": "user-123",
    },
    stream=True,
)

for line in response.iter_lines():
    if not line or not line.startswith(b"data: "):
        continue
    raw = line[6:]
    if raw == b"[DONE]":
        break
    data = json.loads(raw)
    content = data["choices"][0]["delta"].get("content", "")
    print(content, end="", flush=True)

const params = new URLSearchParams({
  query: 'user preferences',
  user_external_id: 'user-123',
});
const res = await fetch(`https://gateway.motai.ai/v1/memory?${params}`, {
  headers: { 'Authorization': `Bearer ${YOUR_API_KEY}` },
});
const { memories } = await res.json();
console.log(memories);

res = requests.get(
    "https://gateway.motai.ai/v1/memory",
    headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
    params={"query": "user preferences", "user_external_id": "user-123"},
)
memories = res.json()["memories"]

await fetch('https://gateway.motai.ai/v1/extract', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${YOUR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    conversation_id: 'conv-20260621-001',
    user_external_id: 'user-123',
    transcript: [
      { role: 'user', content: 'I prefer dark mode' },
      { role: 'assistant', content: 'Noted!' },
    ],
  }),
});

requests.post(
    "https://gateway.motai.ai/v1/extract",
    headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
    json={
        "conversation_id": "conv-20260621-001",
        "user_external_id": "user-123",
        "transcript": [
            {"role": "user", "content": "I prefer dark mode"},
            {"role": "assistant", "content": "Noted!"},
        ],
    },
)

const { status } = await fetch('https://gateway.motai.ai/health')
  .then(r => r.json());
console.log(status); // "ok" or "degraded"