Skip to main content
A student action plan turns one marked answer sheet into advice for that student. It looks at what the student wrote on the questions where they lost marks, reads the feedback the evaluation recorded on those answers, and writes what the student should do next. The plan is created by the Action Plan API and returned as text your platform can display.

​
What does a student action plan contain?

One plan per answer sheet.
The per-question advice covers only the questions where marks were lost. The overall parts look at the whole paper: the AI is also told the student’s total and which questions they got fully right.
The reply also carries the student ID and student name recorded on the answer sheet, the plan’s status, and the date and time it was created.

​
What do the three action types mean?

Every plan and every question in it is labeled with one of three action types.

Remediation

Teach the concept again. The feedback points at a wrong answer or a basic misunderstanding.

Reinforcement

Give the student practice. The feedback suggests the idea is mostly there but not secure.

Extension

Move on to more advanced work on the concept.
The AI chooses these labels from the marks and from what the student wrote. They are the AI’s judgement, not a calculation, and nothing checks a label against the score. Treat all three as a suggestion, not as a measurement.

​
What does it need as input?

One answer sheet that has already been evaluated. You start a plan by sending the answer sheet ID, and nothing else. The service then finds every answer marked below the marks available, groups those answers under their numbered question, and gives the AI, for each question:
  • The question as printed, its marks and the stored model answer.
  • What the student wrote and the marks it got.
  • The feedback recorded against the answer during marking: what was wrong with it, why marks were deducted, and what would improve it.
It also gives the AI the student’s total and the questions they got fully right. The student’s ID and name are not sent to the AI. The advice is built from the student’s own answers and the marking feedback, so the quality of a plan follows the quality of the evaluation. See Evaluate an exam for how an answer sheet gets marked and how that feedback is recorded. A question the student was allowed to skip is not held against them, whether it is an either/or alternative or one of “answer any 8 of 12” in a section. If a teacher corrects the marks on an answer before you ask for a plan, the correction is respected. Raise an answer to full marks and that question drops out of the plan. The teacher’s own note on the correction is not sent to the AI, only the feedback recorded at marking.

​
Who reads the plan?

Your platform decides. The API returns text and question numbers, not a page or a document, so whoever you show it to is your choice. In practice:
  • A student reads the overall action, the skill focus, the confidence tip, and the advice per question.
  • A teacher reads the same plan to see where one student needs help before the next class.
  • Your platform stores the plan against the student, so it can be shown again later.

​
What are the limits?

Only where marks were lost

Questions the student answered for full marks get no advice of their own. A paper with no marks deducted produces a plan with no per-question entries.

One plan at a time

Each request covers one answer sheet. For a whole class, ask for a plan per answer sheet, or use a teacher action plan.

No editing

A plan cannot be edited or approved through the API. If you want a new plan, ask for one again.

Text only

The plan is text. There is no PDF, no spreadsheet, and no practice questions attached to it.

​
Frequently asked questions

No. The plan says what to work on. To create practice questions from it, use the AI Worksheet Builder as a separate step. Nothing is passed between the two products automatically.
Each account can start 20 plans a day by default, counted across student and teacher plans together. The count resets shortly after midnight. Over the limit, the API replies with 429 and states the limit in the message. The limit is a server setting, so the number on your account can differ.
Usually under a minute. The plan is written in the background, so the first request returns straight away. Ask for the plan again to see whether its status is still In Progress, or register the student_action_plan webhook to be told when it is done. The service stops work on a plan that has not finished within 10 minutes and marks it Failed, and you can ask for a new one.
No. Asking for the plan returns the most recent one for that answer sheet. Store each plan on your side if you want a history.
The plan is written in the language of the question paper, so a Hindi paper gets a plan in Hindi. There is no language setting.
Only if your platform shows it to them. There is no parent plan and no parent delivery in the API, and no roles, so who sees a plan is entirely your platform’s decision. See Parent Action Plan.

​
Next steps

How it works

From a marked answer sheet to a finished plan.

Developer guide

Create student and teacher action plans with the API, step by step.