Planned

Assessment API

This family stays honest about its current state. The structure is in place now so the first live assessment capability can be added later without touching infrastructure.

Current status

Draft example placeholder used to validate the product-family contract. No endpoint is live today.

Namespace/v1/assessment
Endpoint count3 documented routes

Planned capabilities

The scope below is descriptive only. No route should be treated as live until the status changes.

  • Quiz generation
  • Question generation
  • Adaptive quiz progression

Endpoint reference

The routes below are documented from the shared platform registry and reflect the current implemented contract for this family. Some routes may be environment-dependent, such as billing when no adapter is configured.

Generate quiz structures.

Placeholder endpoint for generating quiz outlines or complete quiz payloads.

POST /v1/assessment/quizzes/generate
Handler statusPlaceholder

Generate assessment questions.

Placeholder endpoint for question generation workflows.

POST /v1/assessment/questions/generate
Handler statusPlaceholder

Adapt an existing quiz.

Placeholder endpoint for adaptive quiz progression and difficulty tuning.

POST /v1/assessment/quizzes/adapt
Handler statusPlaceholder

Activation path

When implementation moves beyond placeholders, keep the namespace, docs page, and dashboard label aligned. Replace placeholder handlers in the corresponding API module rather than redesigning the platform surface.