Pulumi Cloud REST API Docs, Now Generated from OpenAPI
Blog post from Pulumi
The Pulumi Cloud REST API reference now automatically syncs with the live OpenAPI specification, ensuring documentation accuracy and consistency with the API's functionalities. Previously, the API reference was manually maintained, leading to discrepancies that could confuse users and cause issues for AI agents interacting with the API. The updated system generates the reference from the OpenAPI spec at build time, reflecting any API changes instantly. This advancement enhances reliability for AI agents, improves user navigation with endpoints grouped by product area, and facilitates seamless interaction with linked response definitions. Despite the transition to a generated format, the reference maintains the same URL, ensuring continuity for existing bookmarks and links while accepting input for improvements through community feedback.