# Source: https://www.mintlify.com/docs/integrations/sdks/speakeasy.md

> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakeasy

> Automate SDK code samples in your API playground.

Autogenerated code snippets from Speakeasy SDKs can be integrated directly into Mintlify API reference documentation. SDK usage snippets are shown in the [interactive playground](/api-playground/overview) of Mintlify-powered documentation sites.

<Frame>
    <img src="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=61aa5501cca4cb4156fdbed1f9fcbe03" alt="A Mintlify API playground with Speakeasy code snippets." data-og-width="2560" width="2560" data-og-height="1440" height="1440" data-path="images/speakeasy/mintlify-with-speakeasy-openapi.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=280&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=f534e524643696705d24397b587c020a 280w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=560&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=68efc971b3352f5e2a369f156b023f0e 560w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=840&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=c48b14ad3cf72fb11a3ec91bb2a1c135 840w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=1100&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=1caa057b84e7f9d18c399d82671aab9f 1100w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=1650&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=06a46bd0a429de31763c914fd80cc4e2 1650w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/mintlify-with-speakeasy-openapi.png?w=2500&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=39db38cdea0ee4d231e8071b75d4de8b 2500w" />
</Frame>

## Prerequisites

To integrate Mintlify with Speakeasy, you'll need the following:

* A [Mintlify documentation repository](/quickstart#creating-the-repository).
* A Speakeasy-generated SDK with a configured [automated code sample URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls).

## Setting up the integration

To integrate Speakeasy with Mintlify, you must get the API's combined spec public URL from the registry and update your `docs.json` configuration file.

### Get the API's combined spec public URL from the registry

Navigate to your [Speakeasy Dashboard](https://app.speakeasy.com) and open the **API Registry** tab. Open the `*-with-code-samples` entry for the API.

<Frame>
    <img src="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=c31db82b03febfd0d6fa239c810c116f" alt="Screenshot of the Speakeasy API Registry page. The API Registry tab is emphasized with a red square and the number 1 and the entry for the API is emphasized with a red square and the number 2." data-og-width="2560" width="2560" data-og-height="1440" height="1440" data-path="images/speakeasy/openapi-registry-and-combined-spec.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=280&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=a3c6d930b01d43d9c86165f5a21ceeee 280w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=560&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=6df4f45f87ec5af438a652b0903ff74b 560w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=840&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=4452036029237656e8d12bfbc349870e 840w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=1100&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=13e877e0ebb6e2c7e964288f69510684 1100w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=1650&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=cf573c47aef30f4733a529aa79edb454 1650w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/openapi-registry-and-combined-spec.png?w=2500&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=c4b12a20171e3943e1d1d089c09765f9 2500w" />
</Frame>

<Note>
  If the entry is not labeled **Combined Spec**, ensure that the API has an [automatic code sample URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls) configured.
</Note>

From the registry entry's page, copy the provided public URL.

<Frame>
    <img src="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=7d315613202f1097255a94940cce881b" alt="Screenshot showing the combined spec registry entry with the copy URL function emphasized with a red square." data-og-width="2560" width="2560" data-og-height="1440" height="1440" data-path="images/speakeasy/copy-combined-spec-url.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=280&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=82a64d5244aa8c142eb1c97337491ba2 280w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=560&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=e7fedc49789e7606ac7d5cec7efc1cc2 560w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=840&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=c11dc3dfc52f944a378fe0d42040ee5b 840w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=1100&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=0b5cddbee64534c4e1967a162128d42e 1100w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=1650&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=872f3bfe7cd6d51a078c070b0d8a70ba 1650w, https://mintcdn.com/mintlify/f7fo9pnTEtzBD70_/images/speakeasy/copy-combined-spec-url.png?w=2500&fit=max&auto=format&n=f7fo9pnTEtzBD70_&q=85&s=0d9e6f35fe34076cf0a0faedaf90175a 2500w" />
</Frame>

### Update your `docs.json` configuration file

Add the combined spec URL to an **Anchors** or **Tabs** section in your `docs.json` file.

Add the combined spec URL to an anchor by updating the `anchor` field in your `docs.json` file as follows:

```json docs.json theme={null}
{
  "anchors": [
    {
      "name": "API Reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL",
      "url": "api-reference",
      "icon": "square-terminal"
    }
  ]
}
```

Add the combined spec URL to a tab by updating the `tab` field in the `docs.json` file as follows:

```json docs.json theme={null}
{
  "tabs": [
    {
      "name": "API Reference",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

Speakeasy-generated code snippets can now be viewed in your API docs and interacted with in the playground.