The OpenAPI spec is the most broadly adopted industry standard for describing modern APIs. Companies of all shapes and sizes are using OpenAPI specs to automatically generate documentation, SDKs, tests, and more. But migrating an existing public API to OpenAPI can be challenging and the ecosystem of tooling can be tough to navigate effectively.
In this talk, we’ll deep dive into HelloSign’s journey migrating to OpenAPI and explore how it’s used to automatically generate a delightful developer experience across documentation and SDKs. We’ll take a broad look at the OpenAPI ecosystem and discuss approaches to selecting the right tooling for your situation. You’ll leave with a better understanding of the OpenAPI spec, the different types of tooling it unlocks, and why it’s worth considering for your own public API.

I work on the "API Pod" at HelloSign (Dropbox) and own developer experience. In early 2022 we migrated to OpenAPI and use that to power our documentation and all our SDKs. This is one of a few talk ideas that explore the same topic from different lenses.