Skip to main content
POST
/
worksheet
/
v1
/
generate-worksheet
/
{work_sheet_id}
Generate Worksheet
curl --request POST \
  --url https://api-staging.crazygoldfish.com/worksheet/v1/generate-worksheet/{work_sheet_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question_type_summary": [
    {
      "question_type": "mcq_single_answer",
      "count": 2
    },
    {
      "question_type": "mcq_multiple_answer",
      "count": 3
    },
    {
      "question_type": "true_false",
      "count": 1
    },
    {
      "question_type": "very_short_answer",
      "count": 1
    },
    {
      "question_type": "short_answer",
      "count": 1
    },
    {
      "question_type": "long_answer",
      "count": 2
    }
  ],
  "bloom_summary": [
    {
      "bloom": "remember",
      "question_count": 3
    },
    {
      "bloom": "understand",
      "question_count": 3
    },
    {
      "bloom": "apply",
      "question_count": 3
    },
    {
      "bloom": "analyze",
      "question_count": 1
    }
  ],
  "difficulty_summary": [
    {
      "difficulty": "easy",
      "question_count": 3
    },
    {
      "difficulty": "medium",
      "question_count": 5
    },
    {
      "difficulty": "hard",
      "question_count": 2
    }
  ],
  "question_summary": [
    {
      "question_type": "mcq_single_answer",
      "learning_objectives": "Students will explain ...",
      "bloom": "understand",
      "difficulty": "easy",
      "question_count": 1
    },
    {
      "question_type": "long_answer",
      "learning_objectives": "Students will differentiate materials...",
      "bloom": "remember",
      "difficulty": "hard",
      "question_count": 1
    }
  ]
}
'
{
  "detail": [
    {
      "id": "152764ca-1685-427c-aba7-4b92dcc0d60f",
      "msg": "Worksheet generation initiated successfully."
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.crazygoldfish.com/llms.txt

Use this file to discover all available pages before exploring further.

​
When to use this endpoint

Call this endpoint after you have:
  1. Created a worksheet shell and initialized its metadata.
  2. Finalized the question configuration using the configuration APIs.
  3. Validated that the totals across question_summary, bloom_summary, difficulty_summary, and question_type_summary match number_of_questions.
Typical scenarios:
  • LMS or homework platforms that queue auto‑generated practice sheets once teachers approve the configuration.
  • Admin dashboards that generate board‑aligned worksheets in bulk for multiple classes.
  • Programmatic integrations that run nightly worksheet jobs based on student performance data.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
work_sheet_id
string<uuid>
required

Unique identifier of the worksheet

Body

application/json
​
question_type_summary
object[]
required

Summary of question types and their counts.

​
bloom_summary
object[]
required
​
difficulty_summary
object[]
required
​
question_summary
object[]
required

Response

Worksheet generation initiated successfully.

​
detail
object[]