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
- Edit a page that uses the old macro and type
/apifolio. - In "Found 1 Open API (Swagger) macro on this page", click Import, Use this file or Attach the file.
- Check the preview and the display options, then click Save.
- 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.