# Import from OpenAPI specs

If you use Swagger and have an OpenAPI spec available for your APIs, you can use this spec to provide API information to KushoAI and get started. Using OpenAPI spec allows you to import multiple APIs into KushoAI in one go and provide additional information about your APIs (datatypes of fields, range of values, optional/compulsory, etc.).

Here's how you can use an OpenAPI spec to create a test suite:

1. On the Test Suites page, click on the "Create" button

   

2. Click on the "Import OpenAPI Specification" button

   

3. #TODO - Instructions on how to export from swaggerhub

4. Paste your OpenAPI spec or upload the JSON file

   

5. Select the APIs that you wish to import

   

6. Enter the server URL you wish to use for testing. Don't worry about having to stick to a single URL. You can use environments and variables to setup as many different URLs you want

   

7. Click on "Generate" to start the test generation

   

8. Generation using OpenAPI spec happens in async. You'll receive an email once the generation is completed after which you can view your test suites on the Test Suites page. In the meanwhile, you can use the Test Suite Generation Status page to check the status of your APIs

Note that we only support OpenAPI v3 as of now. If you have a v2 spec which you which to import, you can use one of the many freely available tools to convert the spec to v3 first. Here's a list of converters you can use for this:

#TODO

Alternatively, you can import the v2 spec in Postman and export it as a collection. Then use our Postman option to import it.