Move from Open API (Swagger) Editor for Confluence to Legilio

Replace the Open API Viewer macro with Legilio, page by page. The macro comes from the Open API (Swagger) Editor for Confluence app by EliteSoft. Legilio runs on Atlassian, so your specs never leave it.

Where the spec comes from

The old macro’s settings show one of these:

• A URL, including a link to a file in Git. Download the file, attach it to the page and pick it in Legilio.
• A spec in the macro body, used when the URL is empty. Copy it and paste it into Legilio.
• An attachment. Pick the same file in Legilio.

Steps

1. Keep the old app installed until you finish: its macro settings show where each spec comes from.
2. Edit the page, select the old macro and click the pencil icon to open its settings.
3. Type /legilio next to it, pick Legilio API Docs and set the spec as described above.
4. Check the docs, delete the old macro and publish the page.

If the old macro loaded the spec with a username, password or token, they’re stored in the page and its history. Change them once you’ve switched.

What works differently

Legilio has no Try it out and doesn’t load specs from URLs or Git, because it never connects to anything outside Atlassian.