diff --git a/schemas/constructs/v1beta1/academy/openapi.yml b/schemas/constructs/v1beta1/academy/openapi.yml
index 36d5db138b..7aed0b00d3 100644
--- a/schemas/constructs/v1beta1/academy/openapi.yml
+++ b/schemas/constructs/v1beta1/academy/openapi.yml
@@ -810,7 +810,7 @@ components:
             - completed
             - failed
             - withdrawn
-          description: Status of the user's course registration
+          description: "Status of the user's academy content registration:\n- registered: Learners who are 'in-progress' and have not yet finished the content.\n- completed: Learners who have successfully finished the content.\n- failed: Learners who have attempted to complete the content but did not meet the passing criteria.\n- withdrawn: Learners who have unenrolled from the content."
           x-oapi-codegen-extra-tags:
             db: "status"
 
@@ -1429,3 +1429,4 @@ components:
           type: integer
         page:
           type: integer
+