I just recently needed it for this, but I had to build an integration with a 3rd party, so I added the OpenAPI doc, and gave it some example code from what I wanted to look like and was able to build a typed API client for the integration.