Quickstart

curl https://api.respan.ai/api/v1/decisions \
  -H "Authorization: Bearer $RESPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "span-02",
    "state": {
      "customer_message": "My package arrived damaged and nobody answers my emails. I want a refund now.",
      "order": { "id": 123, "days_late": 4 }
    },
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this ticket?",
        "criteria": {
          "returns": "Exchanges, wrong or damaged items",
          "shipping": "Delivery status, delays, lost packages",
          "billing": "Charges, invoices, payment problems"
        }
      },
      "wants_refund": { "type": "noul", "instructions": "Does the customer ask for a refund?" },
      "frustration": {
        "type": "score",
        "instructions": "How frustrated is the customer?",
        "criteria": ["Calm or positive", "Mildly annoyed", "Angry or threatening to leave"]
      },
      "days_late": { "type": "number", "instructions": "How many days late is the order?" }
    }
  }'

import os
import requests

response = requests.post(
    "https://api.respan.ai/api/v1/decisions",
    headers={"Authorization": f"Bearer {os.environ['RESPAN_API_KEY']}"},
    json={
        "model": "span-02",
        "state": {
            "customer_message": "My package arrived damaged and nobody answers my emails. I want a refund now.",
            "order": {"id": 123, "days_late": 4},
        },
        "questions": {
            "department": {
                "type": "choice",
                "instructions": "Which team should handle this ticket?",
                "criteria": {
                    "returns": "Exchanges, wrong or damaged items",
                    "shipping": "Delivery status, delays, lost packages",
                    "billing": "Charges, invoices, payment problems",
                },
            },
            "wants_refund": {"type": "noul", "instructions": "Does the customer ask for a refund?"},
            "frustration": {
                "type": "score",
                "instructions": "How frustrated is the customer?",
                "criteria": ["Calm or positive", "Mildly annoyed", "Angry or threatening to leave"],
            },
            "days_late": {"type": "number", "instructions": "How many days late is the order?"},
        },
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.respan.ai/api/v1/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RESPAN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "span-02",
    state: {
      customer_message:
        "My package arrived damaged and nobody answers my emails. I want a refund now.",
      order: { id: 123, days_late: 4 },
    },
    questions: {
      department: {
        type: "choice",
        instructions: "Which team should handle this ticket?",
        criteria: {
          returns: "Exchanges, wrong or damaged items",
          shipping: "Delivery status, delays, lost packages",
          billing: "Charges, invoices, payment problems",
        },
      },
      wants_refund: { type: "noul", instructions: "Does the customer ask for a refund?" },
      frustration: {
        type: "score",
        instructions: "How frustrated is the customer?",
        criteria: ["Calm or positive", "Mildly annoyed", "Angry or threatening to leave"],
      },
      days_late: { type: "number", instructions: "How many days late is the order?" },
    },
  }),
});

console.log(await response.json());