SentientOne AI Platform

curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{ "message": "Hello!" }'

curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{
    "message": "Get the order details for OrderId: ORD-1234 and UserId: USR-5678"
  }'

{
  "conversation_id": "conv-uuid-...",
  "message": {
    "id": "msg-uuid-...",
    "conversation_id": "conv-uuid-...",
    "role": "assistant",
    "content": "The order ORD-1234 is currently shipped via FedEx (tracking FX-998877)...",
    "token_count": 156,
    "created_at": "2026-03-28T14:30:00Z"
  },
  "tool_calls": [
    {
      "name": "get_order",
      "input": { "order_id": "ORD-1234", "user_id": "USR-5678" },
      "output": "{\"status\":\"shipped\",\"carrier\":\"FedEx\",\"tracking\":\"FX-998877\"}"
    }
  ]
}

curl -N -X POST https://api.sentientone.ai/v1/chat/stream \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{ "message": "Get the order details for OrderId: ORD-1234" }'

data: {"type":"meta","conversation_id":"conv-uuid-..."}

data: {"type":"tool_call","id":"tc-1","name":"get_order","input":{"order_id":"ORD-1234"}}
data: {"type":"tool_result","id":"tc-1","name":"get_order","output":"{\"status\":\"shipped\"}"}

data: {"type":"delta","content":"The order ORD-1234 is"}
data: {"type":"delta","content":" currently shipped via FedEx"}
...
data: {"type":"done","message":{"id":"msg-uuid","role":"assistant","content":"...","token_count":156}}

const res = await fetch("https://api.sentientone.ai/v1/chat/stream", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "text/event-stream",
    "X-Api-Key": "sk-so-your_api_key_here",
    "X-Agent-Id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  },
  body: JSON.stringify({ message: "Get the order details for OrderId: ORD-1234" }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let fullContent = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop() ?? "";
  for (const line of lines) {
    if (!line.startsWith("data: ")) continue;
    const event = JSON.parse(line.slice(6));
    if (event.type === "meta") console.log("conversation:", event.conversation_id);
    if (event.type === "tool_call") console.log("Calling tool:", event.name, event.input);
    if (event.type === "tool_result") console.log("Tool result:", event.output);
    if (event.type === "delta") { fullContent += event.content; process.stdout.write(event.content); }
    if (event.type === "done") console.log("\nTokens used:", event.message.token_count);
  }
}

# First message — starts a new conversation
curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "Look up order ORD-1234 for user USR-5678" }'
# Response: { "conversation_id": "conv-abc-123", "message": { ... } }

# Follow-up — continues the same conversation with full context
curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "What is the delivery ETA for that order?", "conversation_id": "conv-abc-123" }'

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

data: {"type": "error", "code": "ERROR_CODE", "message": "..."}

HTTP/2 200
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 58

HTTP/2 429
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 42

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please retry after 42 seconds."
  }
}

import time, requests

def chat_with_retry(base_url, headers, payload, max_retries=3):
    for attempt in range(max_retries + 1):
        res = requests.post(f"{base_url}/v1/chat", headers=headers, json=payload)

        if res.status_code != 429:
            return res.json()

        reset = int(res.headers.get("X-RateLimit-Reset", 60))
        wait = reset + (2 ** attempt)  # backoff on top of reset
        print(f"Rate limited. Retrying in {wait}s (attempt {attempt + 1}/{max_retries})")
        time.sleep(wait)

    raise Exception("Rate limit exceeded after max retries")

async function chatWithRetry(baseUrl, headers, payload, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = await fetch(`${baseUrl}/v1/chat`, {
      method: "POST",
      headers,
      body: JSON.stringify(payload),
    });

    if (res.status !== 429) return res.json();

    const reset = parseInt(res.headers.get("X-RateLimit-Reset") ?? "60", 10);
    const wait = (reset + 2 ** attempt) * 1000;
    console.log(`Rate limited. Retrying in ${wait / 1000}s (attempt ${attempt + 1}/${maxRetries})`);
    await new Promise((r) => setTimeout(r, wait));
  }
  throw new Error("Rate limit exceeded after max retries");
}

# From your e-commerce backend, customer portal, or mobile app
curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "Get full order details including delivery and products for OrderId: ORD-78923 and UserId: USR-4412" }'

{
  "conversation_id": "conv-uuid-...",
  "message": {
    "id": "msg-uuid-...",
    "conversation_id": "conv-uuid-...",
    "role": "assistant",
    "content": "{\n  \"order_id\": \"ORD-78923\",\n  \"status\": \"shipped\",\n  \"customer\": \"USR-4412\",\n  \"items\": [\n    { \"name\": \"Wireless Headphones\", \"qty\": 1, \"price\": 89.99 },\n    { \"name\": \"USB-C Cable\", \"qty\": 2, \"price\": 12.99 }\n  ],\n  \"total\": 115.97,\n  \"delivery\": {\n    \"carrier\": \"FedEx\",\n    \"tracking\": \"FX-998877\",\n    \"estimated_delivery\": \"2026-04-07\",\n    \"status\": \"in_transit\"\n  }\n}",
    "token_count": 198,
    "created_at": "2026-03-28T14:30:00Z"
  },
  "tool_calls": [
    {
      "name": "get_order",
      "input": { "order_id": "ORD-78923", "user_id": "USR-4412" },
      "output": "{\"status\":\"shipped\",\"carrier\":\"FedEx\"}"
    }
  ]
}

curl -X POST https://api.sentientone.ai/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: PRODUCT_AGENT_UUID" \
  -d '{ "message": "Show me the details for product PRD-2210 and suggest similar items" }'

import requests

BASE_URL = "https://api.sentientone.ai"
API_KEY = "sk-so-your_api_key_here"
AGENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"  # from Agents page

headers = {
    "Content-Type": "application/json",
    "X-Api-Key": API_KEY,
    "X-Agent-Id": AGENT_ID,
}

# Single message
response = requests.post(f"{BASE_URL}/v1/chat", headers=headers, json={
    "message": "Get order details for OrderId: ORD-1234, UserId: USR-5678"
})

data = response.json()
print(data["message"]["content"])

# Check if any MCP tools were called
if data.get("tool_calls"):
    for tc in data["tool_calls"]:
        print(f"Tool: {tc['name']}, Input: {tc['input']}")

# Follow-up in same conversation
response2 = requests.post(f"{BASE_URL}/v1/chat", headers=headers, json={
    "message": "What is the delivery ETA?",
    "conversation_id": data["conversation_id"],
})
print(response2.json()["message"]["content"])

const API_KEY = "sk-so-your_api_key_here";
const AGENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"; // from Agents page
const BASE_URL = "https://api.sentientone.ai";

const headers = {
  "Content-Type": "application/json",
  "X-Api-Key": API_KEY,
  "X-Agent-Id": AGENT_ID,
};

// Single request
const res = await fetch(`${BASE_URL}/v1/chat`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    message: "Get order details for OrderId: ORD-1234, UserId: USR-5678",
  }),
});

const { conversation_id, message, tool_calls } = await res.json();
console.log(message.content);
if (tool_calls) console.log("Tools used:", tool_calls.map(t => t.name));

// Multi-turn follow-up
const res2 = await fetch(`${BASE_URL}/v1/chat`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    message: "What is the delivery ETA?",
    conversation_id,
  }),
});
console.log((await res2.json()).message.content);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "sk-so-your_api_key_here");
client.DefaultRequestHeaders.Add("X-Agent-Id", "a1b2c3d4-e5f6-7890-abcd-ef1234567890");

// Single request
var response = await client.PostAsJsonAsync(
    "https://api.sentientone.ai/v1/chat",
    new { message = "Get order details for OrderId: ORD-1234, UserId: USR-5678" }
);
var result = await response.Content.ReadFromJsonAsync<ChatResponse>();
Console.WriteLine(result.Message.Content);

// Multi-turn follow-up
var response2 = await client.PostAsJsonAsync(
    "https://api.sentientone.ai/v1/chat",
    new {
        message = "What is the delivery ETA?",
        conversation_id = result.ConversationId
    }
);
Console.WriteLine((await response2.Content.ReadFromJsonAsync<ChatResponse>()).Message.Content);