POST /api/v1/study/flashcards

Create flashcards

Generates a set of flashcards for a subject and topic. Asynchronous — returns 202 Accepted with a flashcard_set_id and status: generating. Await the study.flashcards.completed webhook or poll Retrieve flashcards.

Parameters

Name	Type	Required	Description
`user_id`	string	required	Your identifier for the student (billing)
`flashcard.subject_id`	uuid	required	Subject (must be on your subscription)
`flashcard.topic_id`	uuid	required	Topic under the subject

Returns

A generating set with flashcard_set_id and a poll_url.

cURL

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

Response

{
  "flashcard_set_id": "1a2b3c4d-...",
  "status": "generating",
  "subject": { "id": "b1d9b7d4-...", "name": "HSC Biology" },
  "topic": { "id": "d85701b5-...", "name": "Heredity" },
  "poll_url": "https://ai.intu.com.au/api/v1/study/flashcards/1a2b3c4d-..."
}