Skip to main content
A teacher action plan looks at one exam across everyone who sat it. It says how the class did, what to act on first, what went wrong on each question and how to teach it again, which learning outcomes the paper assessed, and what each group of students needs. The plan is created by the Action Plan API and returned as text and numbers your platform can display.

​
What does a teacher action plan contain?

Four parts. Each question entry has these parts. The reply also carries the exam name, the plan’s status, and the date and time it was created.

​
How are students grouped?

In two ways. By question. If question 5 has parts (a), (b), and (c), all three parts are pooled into one entry for question 5 rather than listed separately, so the plan reads at the level of the numbered question on the paper. A student appears under every question they lost marks on, so the same student can appear in several entries. By score. Each student is placed in one group by their percentage on the whole paper: Needs support (below 35%), Developing (35% to below 60%), Proficient (60% to below 80%) or Advanced (80% and above). The plan says what each group needs. There is no seating plan. Students are shown by the ID and name you recorded on each answer sheet, so they match the records in your own system. If an answer sheet was uploaded without a student ID, the answer sheet’s own ID appears instead.

​
Where do the learning outcomes come from?

The AI reads the question paper and words the outcomes it assesses in the style of NCERT learning outcomes, such as “explains how sound travels through a medium”. Every question is placed under one outcome. They are the AI’s reading of the paper, not official outcome codes.

​
What do the three action types mean?

Remediation

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

Reinforcement

Give the group 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 how the class did on the question and what students wrote. They are the AI’s judgement, not a calculation, and nothing checks a label against the marks. Treat all three as a suggestion, not as a measurement. The numbers in the plan, such as the class summary and the averages, are computed from the marks.

​
What does it need as input?

One exam that has at least one evaluated answer sheet. You start a plan by sending the exam ID, and nothing else. The plan then covers every answer sheet on that exam, not a class list you choose. The service works out every student’s marks on every question, then gives the AI, for each question the class lost marks on:
  • The question as printed, its marks and the stored model answer.
  • How the class did on it: how many students got full, partial or zero marks or left it blank.
  • The answers that lost marks, with the feedback recorded at marking. An answer many students wrote is sent once with the number of students who wrote it.
Student IDs and names are not sent to the AI. They are added to the plan afterwards. The advice is built from what students wrote and from the marking feedback, so the quality of a plan follows the quality of the evaluation. See Evaluate an exam for how answer sheets get marked and how that feedback is recorded. A question a 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 student drops out of the group for that question. The teacher’s own note on the correction is not sent to the AI, only the feedback recorded at marking.

​
Who reads the plan?

A teacher, or a head of department, through whatever screen your platform builds. The API returns text and question numbers, so:
  • A teacher reads it to plan the next lesson: what to tackle first, which questions to go back over, and which students to call into a smaller group.
  • A head of department compares the insights across exams to see which topics keep coming back.
  • Your platform stores the plan against the exam and shows it next to the results.

​
What are the limits?

Only where marks were lost

A question the whole class answered correctly gets no action of its own. An exam where nobody lost marks produces a plan with the class’s marks and no actions.

The whole exam, every time

You cannot ask for one class, one section, or one group of students. The plan covers all answer sheets on the exam.

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 and numbers. There is no lesson plan, worksheet, or spreadsheet attached to it.

​
Frequently asked questions

No. It suggests an approach in words. To turn that into materials, use the AI Lesson Plan or the AI Worksheet Builder as a separate step. Nothing is passed between the products automatically.
No. The exam needs at least one answer sheet. Without one, the request fails and no plan is created.
Each account can start 20 plans a day by default, counted across teacher and student 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.
The plan is finished but part of it is missing: some questions have no action, or the overview or the learning outcomes could not be written. The plan is readable, and what is missing is simply absent. Ask for a new plan if you need full coverage.
Ask for it again and check the status, or register the teacher_action_plan webhook so the service calls your URL when the work ends. A plan usually takes one to three minutes. 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.
Yes. One request covers every answer sheet on the exam, whatever the class size. A larger class takes longer to write.
The language of the question paper. A Hindi paper gets a plan in Hindi. There is no language setting.
Not through the API. The teacher plan names students, so treat it as staff information. For something written for a student, use a student action plan.

​
Next steps

How it works

From a marked exam to a finished plan.

Developer guide

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