DAST
Adding a single API
-
Last updated: November 6, 2026
-
Read time: 3 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. You can't upload GraphQL API definition files.
To add an API definition by uploading a file:
-
Go to Sites and select Add a new site.
-
Select API from the Site type panel.
-
Enter a unique Site name.
-
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.
-
Click Select file and select the definition file to upload.
-
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. If the definition file is on a server that requires authentication, you can add host credentials. You can validate that the URL is reachable and the file can be parsed.
To add an API definition by providing a URL:
-
Go to Sites and select Add a new site.
-
Select API from the Site type panel.
-
Enter a unique Site name.
-
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.
- Click Host URL and enter the URL where your API definition file is hosted.
-
(Optional) If your API definition file is on a server that requires authentication, click Add host credentials and enter the credentials.
- 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.
Note
If you provide a URL for a Postman Collection, Burp Suite DAST also extracts the credentials for detected authentication schemes. They are shown in the Authentication tab.
If you manually edit the credentials for your site, they may be overwritten if you later click Validate.
Adding captured traffic as an API definition
You can use captured traffic to create an API site without writing an API definition. Burp Suite DAST lists each distinct recorded request as an endpoint.
To add a Burp XML or HAR file, upload the file or provide its URL.
Burp XML files
You can use an XML file saved from Burp Suite Professional to scan captured HTTP requests in Burp Suite DAST.
To save the file:
-
Select the requests you want to scan in Proxy > HTTP history or the site map.
-
Right-click the selection and click Save items.
-
Make sure Base64-encode requests and responses is selected.
-
Enter a file name ending in
.xmland click Save.
For more information about saving requests, see Save items.
Base64 encoding preserves the recorded request data. Without it, saved request bodies may differ from the originals. The parse report warns when this may happen.
Burp Suite DAST combines duplicate requests into one endpoint. It skips items without a usable URL or request and names them in the parse report.
Burp Suite DAST sends each request with its recorded credentials. Authentication that you configure for the site replaces any recorded header with the same name. Burp Suite DAST doesn't detect authentication schemes from recorded headers.
Note
Scanning Burp XML files requires Burp Suite DAST 2026.10.3 or later.
HAR files
Export a HAR file from your browser's developer tools or a proxy. After adding the file, review the requests on the Endpoints tab.
Requests for static assets start deselected. To include a request for an image, stylesheet, script, or font, select its checkbox.
Burp Suite DAST doesn't support:
-
WebSocket entries.
-
Replaying requests in their recorded order.
-
Editing recorded values before scanning.
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.
Related pages
-
Creating sites for added APIs - If you use integrations to discover APIs, you can create sites directly from API finder.