POST
/
llm
/
conversation-turn
Conversation Turn
curl --request POST \
  --url https://ella.navgurukul.org/api/llm/conversation-turn \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "conversation_id": "123e4567-e89b-12d3-a456-426614174000",
  "current_turn": 3,
  "fluency_focus": "After Chat",
  "grammar_focus": "Catch All",
  "level": "A2",
  "level_label": "Finding My Voice",
  "messages": [
    {
      "content": "You are Zoe, a friendly English tutor.",
      "role": "system"
    },
    {
      "content": "Hi there! Let's talk about sports. Do you play cricket?",
      "role": "assistant"
    },
    {
      "content": "Yes, I play cricket with my friends every Sunday.",
      "role": "user"
    }
  ],
  "topic": "Sports",
  "vocab_focus": "Occasional"
}
EOF
{
  "reply": "<string>",
  "correction": "<string>",
  "conversation_complete": false
}

Authorizations

Authorization
string
header
default:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1N2U0NDg0NC04YWRiLTQyNTgtYWI4Mi05MWNmNDUxZTQ4OGEiLCJleHAiOjIwOTY4Njg2Njh9._oyjz0enX_sLYvidUm4EUMq5oTNUpxZmowoxIf5J7dc
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
conversation_id
string
required
messages
MessageIn · object[]
required
topic
string | null
level
string
default:A2
level_label
string
default:Finding My Voice
current_turn
integer
default:1
grammar_focus
string
default:Catch All
vocab_focus
string
default:Occasional
fluency_focus
string
default:After Chat

Response

Successful Response

reply
string
required
correction
string | null
conversation_complete
boolean
default:false