[Yandex Cloud documentation](../../../index.md) > [Yandex API Gateway](../../index.md) > [Concepts](../index.md) > [Specification extensions](index.md) > Integration options > Swagger UI

# x-yc-apigateway-integration:swagger extension

With Swagger UI, you can access interactive documents, test and debug your API from the Swagger UI interface.

You can add an extension to a specification using the [specification constructor](../../operations/spec-constructor/index.md).

## Extension specification {#spec}

Specification example:

```yaml
openapi: "3.0.0"
info:
  version: 1.0.0
  title: Sample API
paths:
  /docs:
    get:
      x-yc-apigateway-integration:
        type: swagger
```

By adding the `/docs` resource with Swagger UI integration to the OpenAPI specification, you will get access to the Swagger UI interface at `/docs`.

The [authorization](../index.md#authorization) and all access policies will apply automatically, because `/docs` is a full-blown endpoint under API Gateway.