POST /api/v1/study/explain_backs

Create explain-back questions

Generates explain-back questions for a subject (and optional topic). Synchronous — returns the questions in the response (201 Created).

Parameters

Name	Type	Required	Description
`user_id`	string	required	Your identifier for the student (billing)
`explain_back.subject_id`	uuid	required	Subject (must be on your subscription)
`explain_back.topic_id`	uuid	optional	Topic; defaults to the subject’s first topic

Returns

A questions array; each has id, prompt, and the audio_url / submit_url to use next. The model answer is withheld until a response is submitted.

cURL

curl -X POST "https://ai.intu.com.au/api/v1/study/explain_backs" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "student-001", "explain_back": { "subject_id": "b1d9b7d4-...", "topic_id": "d85701b5-..." } }'

Response

{
  "questions": [
    {
      "id": "e1f2a3b4-...",
      "prompt": "Explain how crossing over increases genetic variation.",
      "subject_id": "b1d9b7d4-...",
      "topic_id": "d85701b5-...",
      "audio_url": "https://ai.intu.com.au/api/v1/study/explain_backs/e1f2a3b4-.../audio",
      "submit_url": "https://ai.intu.com.au/api/v1/study/explain_backs/e1f2a3b4-.../responses"
    }
  ]
}