[Blog](/blog)/[API lifecycle](/blog/category/api-lifecycle) ## API lifecycle #### [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 #### [What you really need to build an API sandbox](/blog/api-sandbox-requirements) Integration is the most dangerous phase of the API lifecycle. Learn the infrastructure requirements for building a true API sandbox that validates stateful business logic, not just HTTP contracts. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanApril 24, 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 #### [Three Root Causes: Why we lose to the invisible man](/blog/three-root-causes-invisible-man) After identifying unforced errors in API design, I found three root causes on the tennis court that map directly to how we build APIs. Here's what they are and how to fix them. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanFebruary 05, 2026 #### [Beat the Invisible Man: Unforced errors in API design](/blog/beat-the-invisible-man) Most APIs don't fail because competitors outplayed them. They fail because of unforced errors—small mistakes that shouldn't exist. Here's how to identify and eliminate them. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanJanuary 29, 2026 #### [The sandbox reality check](/blog/sandbox-environments-reality-check) Organizations want org-level sandbox environments for thousands of APIs. Here are the proven patterns that work at scale—and why they require platform building blocks, not just automation. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanJanuary 13, 2026 #### [Two approaches to API design - Resources vs Workflows](/blog/api-design-approaches) Exploring resource-first and workflow-first approaches to API design, and why thinking about use cases early can lead to better APIs. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanOctober 28, 2025 #### [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 #### [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 #### [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 #### [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 #### [RFC 9457: Better information for bad situations](/blog/problem-details-9457) RFC 9457 evolves the standard for describing API errors by building on RFC 7807. Come learn what's new, what to expect, and how you can use it in your own APIs. ![avatar](/content-assets/lorna-94372d476165ef10.png) By Lorna MitchellOctober 25, 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 #### [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 #### [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 #### [What's an API?](/blog/whats-an-api) API is an acronym for application programming interface. ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanFebruary 11, 2022 #### [API-first design](/blog/api-first) ![avatar](/content-assets/adam-b1c762e267cef6b1.png) By Adam AltmanMay 06, 2018