Chat

POST https://api.getsuko.com/api/chat

Authorization: Bearer sk_live_your_key
Content-Type: application/json

{
  "message": "Do you have gluten-free options?",
  "history": [
    {
      "role": "user",
      "content": "What time do you open?"
    },
    {
      "role": "assistant",
      "content": "We open at 11am Monday to Saturday."
    }
  ],
  "session_id": "optional-uuid"
}

{
  "message": "Yes! We have 8 gluten-free dishes...",
  "session_id": "uuid",
  "widget": null,
  "usage": {
    "used": 47,
    "limit": 500,
    "remaining": 453,
    "month": "2026-06"
  }
}

{
  "message": "I'd be happy to help with a reservation!",
  "widget": {
    "type": "reservation_form"
  },
  "usage": { "..." : "..." }
}