Skip to content

Commit 23e9713

Browse files
Update api-playground/openapi-setup.mdx
1 parent f0c6f1b commit 23e9713

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

api-playground/openapi-setup.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -500,14 +500,24 @@ openapi-schema: OrderItem
500500
---
501501
```
502502

503+
```mdx With specific file
504+
---
505+
openapi-schema: path/to/openapi.json OrderItem
506+
---
507+
```
508+
503509
```mdx Format
504510
---
505511
openapi-schema: "schema-key"
512+
# or
513+
openapi-schema: "filepath schema-key"
506514
---
507515
```
508516

509517
</CodeGroup>
510518

519+
When you have multiple OpenAPI files with schemas that have the same name, you can specify which file to use by including the filepath before the schema name. This is useful for multi-language documentation where you have translated versions of the same schema in different OpenAPI files.
520+
511521
## Webhooks
512522

513523
Webhooks are HTTP callbacks that your API sends to notify external systems when events occur. Webhooks are supported in OpenAPI 3.1+ documents.

0 commit comments

Comments
 (0)