POST
/api/v1/mark/essays
Mark an essay
Marks a free-form essay (no pre-defined assessment). Returns 202 Accepted with a submission_id and marking_id; poll Retrieve an essay marking or await the webhook.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id |
string | required | Your identifier for the student (billing) |
file |
file/url | required | The essay (PDF) |
subject_id |
uuid | optional | Subject for grounding |
topic_id |
uuid | optional | Topic for grounding |
prescribed_text |
string | optional | The text the essay responds to |
question |
string | optional | The essay question |
Returns
A submission_id, marking_id, and status.