> For the complete documentation index, see [llms.txt](https://docs.seldon.ai/mlserver/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.seldon.ai/mlserver/user-guide/openapi.md).

# OpenAPI Support

MLServer follows the Open Inference Protocol (previously known as the "V2 Protocol"). You can find the full OpenAPI spec for the Open Inference Protocol in the links below:

| Name                       | Description                                                                                          | OpenAPI Spec                                                                                 |
| -------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Open Inference Protocol    | Main dataplane for inference, health and metadata                                                    | [dataplane.json](https://github.com/SeldonIO/mlserver/openapi/dataplane.json)                |
| Model Repository Extension | Extension to the protocol to provide a control plane which lets you load / unload models dynamically | [model\_repository.json](https://github.com/SeldonIO/mlserver/openapi/model_repository.json) |

## Swagger UI

On top of the OpenAPI spec above, MLServer also autogenerates a Swagger UI which can be used to interact dynamycally with the Open Inference Protocol.

The autogenerated Swagger UI can be accessed under the `/v2/docs` endpoint.

{% hint style="info" %}
Besides the Swagger UI, you can also access the *raw* OpenAPI spec through the `/v2/docs/dataplane.json` endpoint.
{% endhint %}

![](https://3683110819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGs2qYLjlnihwBpOkWCx%2Fuploads%2Fgit-blob-07c0990e0aff88a30e7dc97e25783b36372ef301%2Fswagger-ui.png?alt=media)

## Model Swagger UI

Alongside the [general API documentation](#Swagger-UI), MLServer will also autogenerate a Swagger UI tailored to individual models, showing the endpoints available for each one.

The model-specific autogenerated Swagger UI can be accessed under the following endpoints:

* `/v2/models/{model_name}/docs`
* `/v2/models/{model_name}/versions/{model_version}/docs`

{% hint style="info" %}
Besides the Swagger UI, you can also access the model-specific *raw* OpenAPI spec through the following endpoints:

* `/v2/models/{model_name}/docs/dataplane.json`
* `/v2/models/{model_name}/versions/{model_version}/docs/dataplane.json`
  {% endhint %}

![](https://3683110819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGs2qYLjlnihwBpOkWCx%2Fuploads%2Fgit-blob-a877636b7b2a48dd61e880bb295eac560701eeb7%2Fswagger-ui-model.png?alt=media)