Move to Legilio from another OpenAPI or Swagger macro

Pages switch to Legilio one macro at a time: you set up a Legilio macro next to the old one and then delete the old one.

Guides for specific apps

• Open API (Swagger) Integration by Toshihiro Sato
• Visualize OpenAPI (Swagger) documentation by Dutch Beginners
• Swagger UI for Confluence by Tech Labs
• Open API (Swagger) Editor for Confluence by EliteSoft

Any other app

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 open its settings.
3. Type /legilio next to it and pick Legilio API Docs. If the old macro had the spec pasted in, paste it into Legilio. If it loaded the spec from a URL or Git, download the file, attach it to the page and pick it in Legilio. If it used an attachment, pick the same file.
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.