POST /api/v1/chats

Create a chat

Starts a tutoring conversation. Provide a subject and topic (or let us auto-detect them from the first message), an optional persona, and the student’s first message. Set stream: true to receive the reply as Server-Sent Events.

Parameters

Name	Type	Required	Description
`user_id`	string	required	Your identifier for the student (billing)
`chat.subject_id`	uuid	optional	Subject; auto-detected from the message if omitted
`chat.topic_id`	uuid	optional	Topic within the subject
`chat.persona_id`	uuid	optional	Persona to use; a sensible default is chosen otherwise
`chat.message`	string	required	The student’s first message
`chat.file`	file/url	optional	An image or PDF to attach to the message
`stream`	boolean	optional	Stream the reply as SSE (default `false`)

Returns

The chat object with the first exchange. When streaming, emits start, message_start, content chunks, then done.

cURL

curl -X POST "https://ai.intu.com.au/api/v1/chats" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "student-001",
    "chat": {
      "subject_id": "b1d9b7d4-06bc-45d1-95af-a441eb9b928b",
      "topic_id": "d85701b5-f957-4219-8bbf-eb3400f73990",
      "message": "Explain meiosis simply"
    }
  }'

Response

{
  "chat": {
    "id": "a1b2c3d4-...",
    "subject": { "id": "b1d9b7d4-...", "name": "HSC Biology" },
    "topic": { "id": "d85701b5-...", "name": "Heredity" },
    "persona": { "id": "...", "code": "STELLA", "name": "Stella" },
    "messages": [
      { "id": "...", "role": "user", "content": "Explain meiosis simply" },
      { "id": "...", "role": "assistant", "content": "Meiosis is the cell division that ..." }
    ],
    "usage": { "total_tokens": 245 }
  }
}