:sparkles: example value in documentation

2 files changed, 13 insertions, 3 deletions

diff --git a/api/scripts/generate_openapi_schema.js b/api/scripts/generate_openapi.js

index eb979f14..c9de9fa6 100644
--- a/api/scripts/generate_openapi_schema.js
+++ b/api/scripts/generate_openapi.js
@@ -81,6 +81,18 @@ function apiRoutes() {
 		}
 		if (route.test?.response) {
 			const status = route.test.response.status || 200;
+			let schema = {
+				allOf: [
+					{
+						$ref: `#/components/schemas/${route.test.response.body}`
+					},
+					{
+						example: route.test.body
+					}
+				]
+			};
+			if (!route.test.body) schema = schema.allOf[0];
+
 			obj.responses = {
 				[status]: {
 					...(route.test.response.body
@@ -88,9 +100,7 @@ function apiRoutes() {
 								description: obj.responses[status].description || "",
 								content: {
 									"application/json": {
-										schema: {
-											$ref: `#/components/schemas/${route.test.response.body}`
-										}
+										schema: schema
 									}
 								}
 						  }
diff --git a/api/scripts/generate_body_schema.js b/api/scripts/generate_schema.js

index 22d0b02e..22d0b02e 100644
--- a/api/scripts/generate_body_schema.js
+++ b/api/scripts/generate_schema.js