Move from Swagger UI for Confluence to Legilio

Replace the Swagger UI macro with Legilio, page by page. The macro comes from the Swagger UI for Confluence app by Tech Labs. 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 spec in the macro body. Copy it and paste it into Legilio.
• A URL. Download the file, attach it to the page and pick it 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.