Adopting the OpenAPI schema to generate Plaid’s SDKs

Stephen Jayakar, an engineer on Plaid's Developer Experience team, shares how the company adopted OpenAPI schema to generate its SDKs. The team faced challenges in maintaining three sources of truth for their API and decided to use an OpenAPI schema as a point of reference to generate documentation, client libraries, and part of their API. They learned valuable lessons along the way, including dealing with issues related to the Plaid API implementation, code generators, and templates. The team also had to modify their authentication process to match an OpenAPI authentication schema and made additive changes to ensure compatibility with existing libraries.