Bitwerf · Moving off Connect

Swagger and OpenAPI docs in Confluence Cloud, built on Forge

OpenAPI (Swagger) Viewer by Bitwerf turns an OpenAPI or Swagger specification into API reference documentation on your Confluence pages. It is built on Atlassian Forge, so it keeps working after Connect support ends, and your API design stays inside Atlassian.

Read the documentation

The app is on its way to the Atlassian Marketplace. Email hello@bizzkitt.ai if you want to hear when it is available.

API documentation on a Confluence page, with one operation opened

What you get

The editor with a specification on the left and a live preview on the right

Moving from an older Swagger or OpenAPI macro

Atlassian ends support for apps built on the older Connect platform on 31 January 2027 (Atlassian announcement). If your current Swagger or OpenAPI macro comes from a Connect app, switching takes a few minutes per page:

  1. Install OpenAPI (Swagger) Viewer by Bitwerf from the Atlassian Marketplace.
  2. Open the page, edit the old macro and copy its specification. If the old macro points to an attachment or a URL, open that file and copy its text.
  3. Type /openapi, paste the specification into the new editor and click Save.
  4. Delete the old macro and publish the page.

How it compares with Swagger UI

OpenAPI (Swagger) Viewer by BitwerfSwagger UI in an iframe or Connect app
Where it runsInside Confluence, on Atlassian ForgeOn the app vendor's servers or a page you host
Where the specification livesIn the Confluence pageOften on an external URL or the vendor's side
Try it out requestsNo, nothing is sent outside AtlassianUsually yes
After Connect support endsKeeps workingDepends on the vendor moving to Forge

Questions

Will my existing specification work?

Yes. Paste the same OpenAPI or Swagger document, in JSON or YAML, into the new macro.

Is there a Try it out button?

No. Sending requests to your API from the page would mean data leaving Atlassian. This app shows the documentation and sends nothing anywhere.

Can it load a specification from a URL?

No. Nothing is fetched from outside Atlassian. Paste the specification into the macro; if it is split over several files, bundle it into one document first.

How large can a specification be?

Up to 2 MB per macro. The details of an operation are built when a reader opens it, so large APIs stay quick.

What happens when Connect support ends?

Atlassian ends support for Connect apps on 31 January 2027. OpenAPI (Swagger) Viewer by Bitwerf is built on Forge, the platform Atlassian supports going forward.

Full documentation · Support · Privacy · Security

Bitwerf is a trade name of BizzKitt B.V., Frederikstraat 67, 3034 LD Rotterdam, the Netherlands (KvK 42149345, VAT NL869932354B01).