# Migrate from Open API (Swagger) Integration

Move Confluence pages from Toshihiro Sato's Open API (Swagger) Integration, a Connect app, to Apifolio: import the spec and its display options, and rotate the credentials stored in the old macro.

**Open API (Swagger) Integration** by Toshihiro Sato shows OpenAPI and Swagger specs in Confluence with Swagger UI. 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 `swagger-integration` and `swagger-open-api` macros.

| In the old macro | In Apifolio |
|---|---|
| A spec pasted into 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 (a URL or a Git repository) | Not downloaded: the dialog shows the link, you download the file and click **Attach the file** |
| `userName`, `password`, `token`, `proxy` | Never copied. The dialog names them so you can rotate them |
| Swagger UI display parameters | Mapped when Apifolio has an equivalent: see [the full table](/docs/migration/#display-options-that-carry-over) |

The **Classic (Swagger style)** layout is preselected, so the page keeps a familiar look. You can switch to the modern three-pane layout in the same dialog.

The app's `asyncapi` macro can't be imported: Apifolio shows OpenAPI 3.x and Swagger 2.0 documents only.

## 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.
5. Revoke the tokens and passwords that were stored in the old macro, and create new ones where you still need them: they remain in the page history.

Details: [Moving from another app](/docs/migration/).

## What changes for readers

- **Try it out** is replaced by [Edit request](/docs/edit-request/): readers fill in parameters, the body and credentials, and copy a ready-to-run request in one of [17 languages](/docs/code-samples/). Nothing is sent from Confluence.
- Specs that came from a URL or a Git repository are now page attachments. Keep them up to date from your CI: see [Keep the docs in sync](/docs/keep-in-sync/).
- New: search that understands pasted URLs and typos, PDF and Word exports with the full reference, Copy for AI and the Rovo agent.

See [What Apifolio does not do, and why](/docs/what-apifolio-does-not-do/).

Open API (Swagger) Integration is a product of Toshihiro Sato. Apifolio is an independent product, not affiliated with or endorsed by its vendor.
