Add SDK examples

Add SDK code samples to your API documentation with autogenerated examples from Speakeasy and Stainless across multiple languages.

If your users interact with your API using an SDK rather than directly through a network request, you can use the x-codeSamples extension to add code samples to your OpenAPI document and display them in your OpenAPI pages.

Add this property to any request method. It has the following schema.

lang · string · required

The language of the code sample.

label · string

The label for the sample. This is useful when providing multiple examples for a single endpoint.

source · string · required

The source code of the sample.

Here is an example of code samples for a plant tracking app, which has both a Bash CLI tool and a JavaScript SDK.

paths:
  /plants:
    get:
      # ...
      x-codeSamples:
        - lang: bash
          label: List all unwatered plants
          source: |
            planter list -u
        - lang: javascript
          label: List all unwatered plants
          source: |
            const planter = require('planter');
            planter.list({ unwatered: true });
        - lang: bash
          label: List all potted plants
          source: |
            planter list -p
        - lang: javascript
          label: List all potted plants
          source: |
            const planter = require('planter');
            planter.list({ potted: true });