# Import OpenAPI JSON/YAML

IoTIFY allows you to create a basic test for your API endpoints with intelligent payloads and simple automations in one click. Export your API specifications as an OpenAPI 3 JSON or YAML file and IoTIFY can do the work for you.

To get started, go to the Tests interface and click on the Import button on the top right of the screen. 

This will open another overflow menu, here click on `Import from OpenAPI/Swagger YAML/JSON`. This will open a file picker, navigate to the folder where you have stored the JSON or YAML file and open it. 

<figure><img src="/files/vhNVfHreJQgbRlu8tSK4" alt=""><figcaption></figcaption></figure>

The file will now be uploaded and parsed and a new test will be automatically be created and added to your workspace.

<figure><img src="/files/bmwPCBYVBev45Q9D7Gk4" alt=""><figcaption></figcaption></figure>

Click on this test to open up the definition and you will see intelligent payloads being created for each method for each route mentioned in the API specifications.

<figure><img src="/files/vNKPrtSP9qvwqLK4rvnl" alt=""><figcaption></figcaption></figure>

Now you just need to add the base server path and you are ready to test your API endpoints.

{% hint style="info" %}
While the engine is smart enough to understand things like names, addresses, and so on and add intelligent payloads. It can sometimes fail to understand what a particular variable demands. In those cases, it is left as `"UNRECOGNIZED"`.&#x20;

It is a good practice to go through all the stages and fix these before running the simulation.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iotify.io/concepts/understanding-a-test/exporting-importing-tests/import-openapi-json-yaml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.