From 26f95aa12e8f999628a7123c4f7e932db4d5c6b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc-Andr=C3=A9=20Bombeck?= <mbombeck@gmail.com>
Date: Thu, 10 Sep 2026 12:28:53 +0200
Subject: [PATCH] chore(api): list the onboarding routes' error codes in the
 catalogue

---
 docs/api/openapi.yaml          | 37 +++++++++++++++++-----------------
 src/lib/openapi/error-codes.ts |  6 ++++++
 2 files changed, 24 insertions(+), 19 deletions(-)

diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml
index 45961ad43..a25039d3c 100644
--- a/docs/api/openapi.yaml
+++ b/docs/api/openapi.yaml
@@ -29988,25 +29988,24 @@ components:
                 mood.restore.invalid, mood.update.invalid; notification-prefs — notification-prefs.body.invalid_json;
                 nutrient — nutrient.batch.invalid, nutrient.batch.too_large, nutrient.daily.invalid,
                 nutrient.read.invalid, nutrient.water.invalid, nutrient.water.invalid_day; onboarding —
-                onboarding.complete.invalid, onboarding.disclaimer.invalid, onboarding.step.completed,
-                onboarding.step.concurrent, onboarding.step.invalid, onboarding.step.outOfOrder,
-                onboarding.step.rateLimited, onboarding.tour.invalid, onboarding.user.notFound; personal_records —
-                personal_records.invalid_query; practitioner — practitioner.invalid; profile —
-                profile.update.emailInUse, profile.update.invalidBody, profile.update.nothingSaved; record_write —
-                record_write.rate_limited; report-selection — report-selection.body.invalid_json,
-                report-selection.body.invalid_shape, report-selection.leaves.unknown; route — route.retired; share-link
-                — share-link.document.decryptFailed, share-link.document.notFound, share-link.document.rateLimited,
-                share-link.documents.invalid, share-link.report.notFound, share-link.report.rateLimited,
-                share-link.selection.forbidden_leaf, share-link.selection.unknown_leaf; sharing —
-                sharing.accept.expired, sharing.accept.not_found, sharing.accept.not_pending, sharing.accept.revoked,
-                sharing.access.denied, sharing.invite.duplicate, sharing.invite.invalid, sharing.invite.invalid_scope,
-                sharing.invite.manage_browser_only, sharing.invite.refused, sharing.invite.self, sharing.not_permitted,
-                sharing.renounce.already_ended, sharing.renounce.not_found, sharing.revoke.already_ended,
-                sharing.revoke.not_found, sharing.session.changed, sharing.switch.invalid,
-                sharing.switch.wrong_transport; source-priority — source-priority.body.invalid_json,
-                source-priority.body.invalid_shape; tokens — tokens.measurements.ceiling_reached; vaccination —
-                vaccination.booster-invalid, vaccination.booster-no-antigen, vaccination.encounter-not-found,
-                vaccination.identity-required, vaccination.invalid, vaccination.link.invalid, vaccination.not-found,
+                onboarding.answers.invalid, onboarding.answers.rateLimited, onboarding.restart.invalid,
+                onboarding.restart.rateLimited; personal_records — personal_records.invalid_query; practitioner —
+                practitioner.invalid; profile — profile.update.emailInUse, profile.update.invalidBody,
+                profile.update.nothingSaved; record_write — record_write.rate_limited; report-selection —
+                report-selection.body.invalid_json, report-selection.body.invalid_shape,
+                report-selection.leaves.unknown; route — route.retired; share-link — share-link.document.decryptFailed,
+                share-link.document.notFound, share-link.document.rateLimited, share-link.documents.invalid,
+                share-link.report.notFound, share-link.report.rateLimited, share-link.selection.forbidden_leaf,
+                share-link.selection.unknown_leaf; sharing — sharing.accept.expired, sharing.accept.not_found,
+                sharing.accept.not_pending, sharing.accept.revoked, sharing.access.denied, sharing.invite.duplicate,
+                sharing.invite.invalid, sharing.invite.invalid_scope, sharing.invite.manage_browser_only,
+                sharing.invite.refused, sharing.invite.self, sharing.not_permitted, sharing.renounce.already_ended,
+                sharing.renounce.not_found, sharing.revoke.already_ended, sharing.revoke.not_found,
+                sharing.session.changed, sharing.switch.invalid, sharing.switch.wrong_transport; source-priority —
+                source-priority.body.invalid_json, source-priority.body.invalid_shape; tokens —
+                tokens.measurements.ceiling_reached; vaccination — vaccination.booster-invalid,
+                vaccination.booster-no-antigen, vaccination.encounter-not-found, vaccination.identity-required,
+                vaccination.invalid, vaccination.link.invalid, vaccination.not-found,
                 vaccination.practitioner-not-found; workout — workout.batch.invalid, workout.batch.payload_too_large,
                 workout.batch.too_large; (unprefixed) — about_me_conflict, ai_response_truncated, coach_prefs_conflict,
                 dashboard_layout_conflict, empty_file, health_score_config_conflict, insights_layout_conflict,
diff --git a/src/lib/openapi/error-codes.ts b/src/lib/openapi/error-codes.ts
index 5f8c6037b..0f2594b56 100644
--- a/src/lib/openapi/error-codes.ts
+++ b/src/lib/openapi/error-codes.ts
@@ -244,6 +244,12 @@ export const ERROR_CODE_CATALOGUE: Readonly<Record<string, readonly string[]>> =
       "onboarding.tour.invalid",
       "onboarding.user.notFound",
     ],
+    onboarding: [
+      "onboarding.answers.invalid",
+      "onboarding.answers.rateLimited",
+      "onboarding.restart.invalid",
+      "onboarding.restart.rateLimited",
+    ],
     personal_records: ["personal_records.invalid_query"],
     practitioner: ["practitioner.invalid"],
     profile: [