Skip to main content

LMS Assessment Attempt API

Summary

Source-backed Draft reference for LMS Assessment Attempt API across the implemented Training Service and, where applicable, Gateway surface.

Audience

API consumers, engineering, QA, support, architecture, security, product, and implementation reviewers.

Reference Content

Lifecycle

Start verifies the assessment and creates an InProgress attempt for a supplied employee reference. Submit rejects a terminal attempt, validates the caller-supplied result through the score value record, stores optional answer material, compares the result with the assessment threshold, stages a pass/fail event, and writes audit/timeline evidence.

No attempt collection/detail retrieval, retry policy, attempt-count limit, server-side answer evaluation, question-level result, or answer-redaction API is mapped. Multiple new attempts may be started for the same assessment/employee. Employee ownership and enrollment eligibility are not enforced.

Confirmed results are 201 start, 200 submission, 404 missing assessment/attempt, 409 duplicate terminal submission, and 400 invalid result. This page deliberately omits actual answers, questions, results, recipients, and employee identifiers.

Source References

  • microservices/src/training-service/Api/TrainingEndpoints.cs
  • microservices/src/training-service/Domain/TrainingEntities.cs
  • microservices/src/training-service/Infrastructure/Persistence.cs

See Also

Keywords

  • LMS API
  • Training Service
  • Source-backed contract

Revision Information

  • Status: Draft
  • Last reviewed: 2026-07-17
  • Review cycle: Quarterly