> For the complete documentation index, see [llms.txt](https://docs.loadmill.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loadmill.com/results-and-teamwork/api-catalog-and-coverage/api-catalog/openapi-upload.md).

# OpenAPI Upload

Uploading OpenAPI specification file will allow the mapping of all the APIs at once and creates full visibility on the coverage of tests executions.

To upload a swagger file, follow the next steps:

1. From the dotted menu at the top-right corner of the screen, select "Import from OpenAPI"\
   ![](https://684333474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHDbUNdi3wPd9vSolzU%2Fuploads%2Fgit-blob-f0c4e90415de6ee946db4e12b860fe3f1a2a8f4b%2Fimage.png?alt=media)
2. Select the file and proceed with the upload

{% hint style="info" %}
Note. Loadmill will use `servers` section to map the name/domain of the service. In case the `servers` section is missing, a prompt will be displayed to let the user select how the data should be mapped.
{% endhint %}

3. In case Loadmill couldn't find the information, the user will be prompted to select the service.

<figure><img src="https://684333474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHDbUNdi3wPd9vSolzU%2Fuploads%2Fgit-blob-07a6a78e9de0b342445e69ac0b86964f4816dce3%2Fimage.png?alt=media" alt=""><figcaption><p>Service selection screen, will pop up if servers information is absent in the openAPI specification</p></figcaption></figure>

{% hint style="info" %}
The service name field will allow both, selection and free text.\
If you want to introduce a new service write it down and select it from the dropdown when finished.\ <img src="https://684333474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHDbUNdi3wPd9vSolzU%2Fuploads%2Fgit-blob-f1be039e54bd98dcd68b4fa0198d42bc55f574f8%2Fimage.png?alt=media" alt="" data-size="original">
{% endhint %}

4. Click on Import\
   The result will be reflected as new/merged api endpoints, either to new or existing service.

Notes:

* Loadmill currently support OpenAPI specification v3.0, It is possible to convert older and Swagger formats to OpenAPI specification via [this swagger editor.](https://editor.swagger.io/)