Guides

Practical notes on publishing API documentation in Confluence.

• How to add OpenAPI & Swagger documentation to Confluence Cloud

  Your options, what to look for in an app, and the problems teams usually hit.

• Fixing “Failed to fetch” and CORS errors in Swagger UI on Confluence

  Why the errors happen when loading a spec or using Try it out, and four ways to fix them.

• What counts as a breaking change in an OpenAPI spec?

  A practical checklist, and how to catch breaking changes before release.

• Moving your OpenAPI macros off Connect

  Atlassian ends support for Connect apps on January 31, 2027.