Skip to content

Quickstart

Make your first API call in under 2 minutes.

Prerequisites

  • A CloMan account with a trained clone
  • An API key (see Authentication)

1. Install an SDK

pip install cloman

npm install @clomanai/sdk

No installation needed.

2. Make Your First Request

from cloman import CloMan

client = CloMan(api_key="cloman_sk_your_key_here")

result = client.decide(context="Should we approve this refund for $49.99?")

print(f"Decision: {result.decision}")
print(f"Confidence: {result.confidence:.0%}")
print(f"Reasoning: {result.reasoning}")

import { CloMan } from "@clomanai/sdk";

const client = new CloMan("cloman_sk_your_key_here");

const result = await client.decide({
  context: "Should we approve this refund for $49.99?",
});

console.log(`Decision: ${result.decision}`);
console.log(`Confidence: ${(result.confidence * 100).toFixed(0)}%`);
console.log(`Reasoning: ${result.reasoning}`);

curl -X POST https://api.cloman.app/api/v1/public/decide \
  -H "X-API-Key: cloman_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "Should we approve this refund for $49.99?",
    "action_type": "general",
    "data": {}
  }'

3. Understand the Response

{
  "decision_id": "dec_abc123",
  "clone_id": "cln_xyz789",
  "clone_name": "Customer Support Clone",
  "decision": "approve",
  "reasoning": "The refund amount is within policy limits and the customer has a valid complaint about a defective product.",
  "confidence": 0.92,
  "confidence_level": "high",
  "requires_human_review": false,
  "was_escalated": false,
  "alternatives_considered": [
    {
      "action": "deny",
      "reason": "Amount exceeds typical refund threshold",
      "confidence": 0.08
    }
  ],
  "processing_time_ms": 234.5,
  "created_at": "2026-02-19T12:00:00Z"
}
Field Description
decision The clone's recommendation
confidence Confidence score (0.0–1.0)
confidence_level high, medium, or low
reasoning Explanation of the decision
requires_human_review Whether the clone recommends human oversight
was_escalated Whether guardrails triggered an escalation

Next Steps