[Blog](/blog)/[API specifications](/blog/category/api-specifications) ## API specifications #### [Redoc CE 3.0 is available](/blog/redoc-3-release) Redoc CE 3.0 is out: one renderer for OpenAPI 3.2, AsyncAPI, GraphQL, and MCP. What's new, and what it means for Redoc 2 pages and Redocly CLI. ![avatar](/content-assets/alex-dfb17032a558c702.png) By Oleksandr VarchukOctober 23, 2026 #### [Generate OpenAPI from real traffic (with AI)](/blog/generate-openapi-from-traffic) The new generate-spec command infers an OpenAPI description from recorded HTTP traffic - with AI refinement. ![avatar](/content-assets/sobaniec-9a901f1d78393065.png) By Adam SobaniecSeptember 14, 2026 #### [Document your MCP server with introspect-mcp](/blog/introspect-mcp) The new introspect-mcp command asks a running MCP server what it can do and records its tools, prompts, and resources in the x-mcp extension of your OpenAPI description. The command also has a --check mode that fails CI when the docs drift. ![avatar](/content-assets/ananskyi-bf57da5cd153a9bc.png) By Dmytro AnanskyiSeptember 11, 2026 #### [What's coming in Redoc CE 3](/blog/redoc-3-whats-new) One engine for OpenAPI 3.2, AsyncAPI, GraphQL, and MCP, plus CSS theming and dark mode. A preview before Redoc CE 3 ships. ![avatar](/content-assets/alex-dfb17032a558c702.png) By Oleksandr VarchukSeptember 04, 2026 #### [Generate realistic Arazzo workflows with AI](/blog/generate-arazzo-with-ai) The generate-arazzo command now has a --with-ai option that turns a one-workflow-per-operation skeleton into realistic multi-step workflows, using your own local AI assistant. ![avatar](/content-assets/ananskyi-bf57da5cd153a9bc.png) By Dmytro AnanskyiSeptember 03, 2026 #### [Open-source, agent-friendly SDKs and tooling from OpenAPI description](/blog/agent-friendly-sdks) Meet redocly generate-client: one OpenAPI description becomes typed SDKs in TypeScript, Python, Go, and PHP — plus validation schemas, query hooks, test mocks, a CLI, and docs. Open source, no dependencies beyond each language's HTTP layer, and built for AI agents. ![avatar](/content-assets/marshevskyi-e90fdb23fd6eb5c5.png) By Roman MarshevskyiSeptember 01, 2026 #### [Arazzo 1.1 Release](/blog/arazzo-specification-1-1-release) Arazzo 1.1 adds AsyncAPI support, workflow composition, selectors, identity-based references, and clearer runtime behavior. ![avatar](/content-assets/ananskyi-bf57da5cd153a9bc.png) By Dmytro AnanskyiMay 20, 2026 #### [Enforcing API security policies](/blog/enforcing-api-security-policies) Securing an API ecosystem requires more than just placing a gateway in front of your services. Effective API security policies must operate as a continuous contract, codified during design and enforced through deployment and runtime access. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanApril 16, 2026 #### [OpenAPI 3.2 is here: what's new and how Redocly supports it](/blog/openapi-3-2) An overview of OpenAPI 3.2 features and how to start using them with Redocly. ![avatar](/content-assets/ivan-150f3905ea3ad133.png) By Ivan KropyvnytskyiMarch 11, 2026 #### [How to optimize your docs for LLMs](/blog/optimizations-to-make-to-your-docs-for-llms) Let's dig into a few practical strategies to make your API documentation work better with AI tools. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanAugust 14, 2025 #### [MCP: what it is, why it matters, and why caution is warranted in 2025](/blog/mcp) Explore the pros and cons of Model Context Protocol (MCP), an emerging standard for AI agent interaction. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanJuly 15, 2025 #### [Redocly CLI for AsyncAPI descriptions](/blog/asyncapi-features) Embrace multiple specification standards with one tool, Redocly CLI. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellSeptember 05, 2024 #### [Lint Arazzo workflow files with Redocly CLI](/blog/arazzo-linting) Adopting new standards requires great tools. Use Redocly CLI to lint your OpenAPI, AsyncAPI and Arazzo format descriptions. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellJuly 24, 2024 #### [OpenAPI parameter types for great API design](/blog/openapi-parameter-types) Great API design makes for great API experience. Pick the parameter type that's going to make everything easier for your user. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellJune 06, 2024 #### [What to do when your API changes](/blog/communicate-api-changes) APIs change, that's reality. What matters is how you communicate that; get it right and create a winning API experience by adding a changelog and API description versions. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellMay 22, 2024 #### [API council: the wisdom of your API crowd](/blog/api-council) Invite the stakeholders inside your organization to the table and make your API the best it can be ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellApril 17, 2024 #### [Meet the Museum OpenAPI description](/blog/museum-api-introduction) Learn about the Museum API, a modern OpenAPI example by Redocly designed to teach API enthusiasts about OpenAPI and developer experience. ![avatar](/content-assets/taylor-cartoon-headshot-b3dbf8ff17ecc517.png) By Taylor KrusenMarch 21, 2024 #### [Add OpenAPI tags for next-level API descriptions](/blog/add-openapi-tags-for-next-level-api-descriptions) Tag your OpenAPI endpoints and help your users navigate their own path to success. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellMarch 13, 2024 #### [Love letter to OpenAPI's info section](/blog/loveletter-to-openapi-info) How some humble metadata can multiply the impact of your API. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellMarch 07, 2024 #### [Better examples for better API experience](/blog/openapi-examples) Set API consumers up for success with good and meaningful OpenAPI examples. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellFebruary 28, 2024 #### [Combine OpenAPI Files](/blog/combining-openapis) Make one coherent API from split definitions or multiple API descriptions using Redocly CLI. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellFebruary 02, 2024 #### [Rethinking sub-resources in API design](/blog/no-subresources) A lesson from the trenches ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanJanuary 24, 2024 #### [OpenAPI Operation IDs make good API design](/blog/operationid-is-api-design) Use Operation IDs to write better, more valuable API descriptions and improve developer experience. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellNovember 29, 2023 #### [Cookbook for better Redocly CLI recipes](/blog/redocly-cli-cookbook) Use recipes from the Redocly CLI Cookbook to level up your OpenAPI development and build better APIs. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellNovember 16, 2023 #### [Using Redocly tools for better OpenAPI development](/blog/redocly-tools-better-openapi-development) Learn how Redocly's open source tools create a better developer experience when building an OpenAPI description. ![avatar](/content-assets/taylor-cartoon-headshot-b3dbf8ff17ecc517.png) By Taylor KrusenNovember 08, 2023 #### [Document webhooks with OpenAPI](/blog/document-webhooks-with-openapi) Great developer experiences for reactive API endpoints ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellSeptember 27, 2023 #### [Build rich developer experiences with Markdown in OpenAPI](/blog/markdown-in-openapi) Make a good API experience a great one with rich descriptions in OpenAPI ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellSeptember 19, 2023 #### [Tame your OpenAPI descriptions](/blog/tame-openapi) Use the best modern tools to make even the longest OpenAPI file a delight to work with ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellSeptember 06, 2023 #### [Announcing Redocly CLI 1.0](/blog/redocly-cli-1-0) The OpenAPI CLI utility reaches a milestone stable release ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellAugust 16, 2023 #### [API into AI](/blog/api-into-ai) Smooth management transition and new product announcement. ![avatar](/content-assets/mada-8893298a9f0a6e44.png) By Mada NamtlaApril 01, 2023 #### [Learn OpenAPI in a day](/blog/accelerated-learning-openapi) Accelerated learning approach applied to OpenAPI. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanFebruary 21, 2023 #### [How to hide the download button](/blog/hide-download-button) Answering real questions about how to use OpenAPI to design and describe APIs. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanAugust 10, 2022 #### [How to display schemas separately from operations in API docs?](/blog/display-schemas) Answering real questions about how to use OpenAPI to design and describe APIs. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanMay 26, 2022 #### [OpenAPI overlays](/blog/openapi-overlays) The OpenAPI overlays proposal is flawed. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanMay 25, 2022 #### [How to hide the x-logo](/blog/hide-logo) Answering real questions about how to use OpenAPI to design and describe APIs. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanMay 11, 2022 #### [How to reuse schemas when required properties change across endpoints](/blog/all-of-schemas) Answering real questions about how to use OpenAPI to design and describe APIs. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanMay 04, 2022 #### [Redocly is Remockly](/blog/redocly-is-remockly) ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanApril 01, 2022 #### [Where to store your OpenAPI definitions](/blog/store-openapi-definitions) Part 1 of our series of posts around managing OpenAPI definitions with Redocly ![avatar](/content-assets/swapnil-6a14b4f49fb86196.png) By Swapnil OgaleJanuary 07, 2021 #### [OpenAPI 3](/blog/openapi-3) ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanJanuary 09, 2019