Speakeasy Logo
Skip to Content

Integrate Speakeasy with Scalar


Scalar enables easy creation and maintenance of API documentation. Scalar renders documentation by referencing a live OpenAPI document, making it compatible with Speakeasy’s Automated Code Samples feature.

docs.myapi.com
Scalar docs with successful linked URL

Prerequisites

To integrate Scalar with Speakeasy, you’ll need the following:

Setting up the integration

Get the API’s combined spec public URL from the registry

Navigate to the Speakeasy Dashboard  and click on the Docs tab. Select the Integrate with a Docs Provider option.

app.speakeasy.com
Screenshot showing the Speakeasy Dashboard Docs tab with Integrate with a Docs Provider option

On the Integrate with a Docs Provider page, select the correct OpenAPI document using the Change OpenAPI Documents button. Then, copy the Spec URL.

app.speakeasy.com
Screenshot showing the Integrate with a Docs Provider page with the Spec URL to copy

Make sure the Public toggle is enabled, so Mintlify can access the OpenAPI document.

Import the combined spec URL into Scalar

Open a Scalar project , go to the Reference tab, and click Import URL.

docs.scalar.com
Screenshot of the Scalar UI Project Reference tab, showing the Import URL link

Paste the combined spec URL copied from Speakeasy into the provided field, optionally check Create Link, then click Import.

docs.scalar.com
Screenshot of the Scalar page where the public URL from Speakeasy is added

When the import is complete, the API documentation will be rendered.

docs.scalar.com
Screenshot showing API documentation in Scalar after successfully linking the URL

Next steps

Scalar is more than just an OpenAPI renderer. Visit the official Scalar documentation  to learn more.

Last updated on