Request Studocu Creation
request-creationGenerate a Studocu quiz or mockExam from 1-10 project source artifacts. Waits up to ~3 minutes; returns artifact_id and external_id when created, status creating with external_id when persist is not yet visible, or outcome_unknown on client timeout or in-flight duplicate (check get-project-state before retrying). Optional idempotency_key is forwarded as Idempotency-Key; identical retries without a key still dedupe.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | The kind of creation to generate: quiz or mockExam. | |
| project_id | Yes | UUID of the Studocu project that will own the new creation. | |
| instruction | No | Optional free-text hint for the generating agent (e.g. "focus on chapter 3"). | |
| artifact_ids | Yes | One to ten unique source artifact IDs (studocu://project/{project_id}/source/{uuid}) to generate from. | |
| idempotency_key | No | Optional retry key. Agent OS always sends Idempotency-Key to Alpha (this value, or a fingerprint of project/type/sources/instruction). Reuse with a different body is rejected. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| status | Yes | created: persisted and linked (artifact_id and external_id). creating: generation finished but Alpha identity is not yet visible (external_id matches get-project-state creation rows). outcome_unknown: client timeout or an in-flight duplicate (check get-project-state; do not mint a new key). Terminal failures use MCP isError, not a status value. | |
| artifact_id | No | Agent OS artifact ID of the new creation. Present when status is created. | |
| external_id | No | Kind-specific downstream id (quizId or mockExamId). Present on created and creating; match the same field on get-project-state creation rows. Omitted on timeout. |