DAST

Adding a single API

• Last updated: January 29, 2026

• Read time: 2 Minutes

This page explains how to create a site for a single API. You can add an API definition by uploading a file or providing a URL.

Adding API definitions by uploading a file

When you upload an API definition file, Burp Suite DAST uses that version for every scan until you upload a new one.

To add an API definition by uploading a file:

1. Go to Sites and select Add a new site.

2. Select API from the Site type panel.

3. Enter a unique Site name.

4. To add the site to an existing folder, select from the Site folder drop-down menu. Leave the field blank to create the site at the top level of the site tree.

5. Click Select file and select the definition file to upload.

6. If you upload a Postman Collection, you are given the option to upload a Postman environment file. Burp Suite DAST merges the environment variables with your Postman Collection. Click Add environment file and select your environment file.

Adding API definitions by providing a URL

When you provide a URL, Burp Suite DAST uses the latest version of the API definition for every scan. You can validate that the URL is reachable and the file can be parsed.

To add an API definition by providing a URL:

1. Go to Sites and select Add a new site.

2. Select API from the Site type panel.

3. Enter a unique Site name.

4. To add the site to an existing folder, select from the Site folder drop-down. Leave the field blank to create the site at the top level of the site tree.

5. Click Host URL and enter the URL where your API definition file is hosted.
6. Click Validate to confirm that Burp Suite DAST can reach the URL and parse the API definition. If successful, the Endpoints tab lists the parsed endpoints.

Saving and scanning your site

Once you've finished creating your site, click Save.

Burp Suite DAST adds the new API to the site tree and prompts you to schedule a scan.