From ed6fa861d758f01639d20013cecd918ebdb0650b Mon Sep 17 00:00:00 2001 From: Kathryn Isabelle Lawrence Date: Fri, 26 Sep 2025 11:50:25 -0700 Subject: [PATCH 1/2] add filename in openapi-schema frontmatter docs --- api-playground/openapi-setup.mdx | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index de396cc57..3c2db4693 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -508,6 +508,24 @@ openapi-schema: "schema-key" +If you have the schemas with the same name in multiple files, you can also specify the OpenAPI file: + + + +```mdx Example +--- +openapi-schema: en-schema.json OrderItem +--- +``` + +```mdx Format +--- +openapi-schema: "path-to-schema-file schema-key" +--- +``` + + + ## Webhooks Webhooks are HTTP callbacks that your API sends to notify external systems when events occur. Webhooks are supported in OpenAPI 3.1+ documents. From 9012a13359ce0791811649379bc87c2140ce07d7 Mon Sep 17 00:00:00 2001 From: Kathryn Isabelle Lawrence Date: Fri, 26 Sep 2025 11:51:55 -0700 Subject: [PATCH 2/2] english is my first language --- api-playground/openapi-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 3c2db4693..f9235eef2 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -508,7 +508,7 @@ openapi-schema: "schema-key" -If you have the schemas with the same name in multiple files, you can also specify the OpenAPI file: +If you have schemas with the same name in multiple files, you can also specify the OpenAPI file: