Generate Quiz or Mock Exam
request-creationAsk Studocu to generate a quiz or mock exam from 1 to 10 project sources. Can take about 3 minutes. If status is creating or outcome_unknown, check get-project-state before calling again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"type": "<type>",
"artifact_ids": "<artifact_ids>"
},
"name": "request-creation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | What to generate: quiz or mockExam. | |
| project_id | Yes | UUID of the project that owns the project sources. Example: 11111111-1111-4111-8111-111111111111. From create-project or get-context. | |
| instruction | No | Optional hint, 1-6000 characters. Example: "focus on chapter 3". Omit for a general quiz or mock exam. | |
| artifact_ids | Yes | 1 to 10 different project source ids to generate from. Each id looks like studocu://project/{project_id}/source/{uuid} and must belong to project_id. Get them from add-document-sources or get-project-state. Do not pass creation ids. | |
| idempotency_key | No | Optional retry key, 1-256 characters. Send the same key when you retry the same request. A different request body with a used key is rejected. Omit to let Studocu derive a key from the request; identical retries still count as the same request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Studocu web link for the user: the creation when status is created, otherwise its project. Share it with the user. | |
| type | Yes | ||
| status | Yes | created: saved, with artifact_id and external_id. creating: generation finished but the new creation is not linked yet; match external_id on get-project-state. outcome_unknown: the call timed out or a duplicate is still running; check get-project-state and do not send a new retry key. Failures come back as errors, not as a status. | |
| artifact_id | No | Agent OS artifact ID of the new creation. Present when status is created. | |
| external_id | No | Quiz id or mock-exam id. Present when status is created or creating. Match it on get-project-state. Omitted when the call times out. |