Skip to main content
POST
Add lesson plan enrichment blocks
Step 4 of 4 (optional) in Build a lesson plan. This call starts an async job.

Rules

  • Call this after Get lesson plan content returns status: "Completed". An earlier call returns 400 Lesson plan instructional framework builder is not finalized!.
  • Send every block you want in one call, as additional_blocks. They are generated together, in one job.
  • Use the keys from List enrichment block options.
  • duration_minutes is required.
  • This step runs once per lesson plan. A second call returns 400 unless the first one failed, so you can’t add more blocks later.
duration_minutes here only guides the AI. It doesn’t change the lesson’s duration_minutes, and the API doesn’t check it against the lesson or against the 30 to 90 minute range. Send the lesson’s own duration unless you have a reason not to.
Unknown values in additional_blocks aren’t rejected. They are passed to the AI as written, which produces poor output, so validate them against the list endpoint first.

Next step

Get lesson plan enrichment blocks

Poll until status is Completed, or wait for the lesson_plan_additional_enrichment_blocks webhook.

Authorizations

Authorization
string
header
required

Access token from Get an access token.

Path Parameters

lesson_plan_id
string<uuid>
required

The lesson plan id returned by Start a lesson plan.

Example:

"7d2f1b90-4c6a-4f3e-b1d7-9a5e2c8f0b34"

Body

application/json
additional_blocks
enum<string>[]
required

Block keys from List enrichment block options. Unknown keys are not rejected, they just produce poor output.

Available options:
differentiation,
reflection_feedback,
real_life_connections,
interdisciplinary_connections,
emotional_social_development,
classroom_environment
duration_minutes
integer
required

Minutes the enrichment blocks should assume. This only guides the AI. It doesn't change the lesson's duration_minutes and isn't checked against it.

Response

The job was queued. Poll Get lesson plan enrichment blocks or wait for the lesson_plan_additional_enrichment_blocks webhook.

detail
object[]