Migrate from Open API (Swagger) Editor for Confluence

Move Confluence pages from EliteSoft's Open API (Swagger) Editor for Confluence, a Connect app, to Apifolio: import the spec into a page attachment and keep editing it as a file.

Open API (Swagger) Editor for Confluence by EliteSoft lets authors write and show OpenAPI and Swagger specs in Confluence. In October 2026 it is a Connect app on the Atlassian Marketplace, and Atlassian ends support for Connect apps on 31 January 2027. Apifolio is a Swagger UI alternative built on Forge that runs on Atlassian.

What the import does

The Apifolio dialog recognises the app's confluence-open-api and open-api macros.

In the old macro In Apifolio
A spec written in the macro Checked, attached to the page as a file named after the API title, and selected
A file attached to a Confluence page Selected, on this page or under Another page
A link to the spec Not downloaded: the dialog shows the link, you download the file and click Attach the file
Credentials Never copied. The dialog names them so you can rotate them
Display parameters Mapped as in the full table; the dialog lists the ones without an equivalent

The Classic (Swagger style) layout is preselected. You can switch to the modern three-pane layout in the same dialog.

Editing the spec after the move

Apifolio shows the spec from a page attachment and doesn't edit it. To change the API:

  • edit the file in your editor or repository and upload it again with the same name (by hand, or from your CI: see Keep the docs in sync);
  • or open the Apifolio dialog, paste the new text in the Paste tab with the same file name and click Save as attachment: it becomes a new version of the attachment.

Confluence keeps every version of the file, and the macro's footer shows which one readers see. See What Apifolio does not do, and why.

Steps

  1. Edit a page that uses the old macro and type /apifolio.
  2. In "Found 1 Open API (Swagger) macro on this page", click Import, Use this file or Attach the file.
  3. Check the preview and the display options, then click Save.
  4. Delete the old macro by hand and publish the page.

Details: Moving from another app.

What changes for readers

  • Try it out is replaced by Edit request: readers fill in parameters, the body and credentials, and copy a ready-to-run request in one of 17 languages. Nothing is sent from Confluence.
  • New: search that understands pasted URLs and typos, PDF and Word exports with the full reference, Copy for AI and the Rovo agent.

Open API (Swagger) Editor for Confluence is a product of EliteSoft. Apifolio is an independent product, not affiliated with or endorsed by its vendor.

View as Markdown