Home / Companies / Redocly / Blog / Post Details
Content Deep Dive

How to display schemas separately from operations in API docs?

Blog post from Redocly

Post Details
Company
Date Published
Author
Adam Altman
Word Count
448
Company Posts That Month
5
Language
-
Hacker News Points
-
Post removed?
No
Summary

Redocly users have expressed a need for a more accessible "data dictionary" for API objects, as the current method of accessing schemas in OpenAPI is seen as cumbersome. The existing implementation is outdated and not user-friendly when displaying multiple schemas or organizing them effectively. To address this, two new approaches have been introduced in the Developer portal 1.1.0-beta.95. The first approach involves grouping all schemas together in a sidebar using the schemaDefinitionsTagName configuration in the Redocly configuration file, while the second approach allows schemas to be tagged with operations using the x-tags specification extension. These features allow for a more organized and accessible display of schemas, ensuring that they can be displayed either collectively or alongside relevant operations as needed.

Trends Found in this Post
Trend Post Mentions Total Month Mentions Posts Companies MoM
LLM 2 85 22 10 +130%
MCP 2 16 9 3 -38%
Use This Data

Use this post, company, and trend context to find content marketing opportunities, perform competitive analysis, or address product feature gaps via the Plushcap MCP server or the Plushcap API.