Execute tests

After uploading your app and XCUI test-suite, you are ready to run your XCUI tests on BrowserStack App Automate. Its easy to execute your tests using the REST API. Here is an example cURL request to start the execution of your XCUI tests :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"devices": ["iPhone X-11"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

In the above example, the devices parameter is used to specify a list of iOS devices to test your app on. The app parameter is used to specify the application under test uploaded to BrowserStack. The testSuite parameter is used to specify the XCUI test-suite uploaded to BrowserStack.

A sample response to the above API request is shown below :

{
    "message": "Success",
    "build_id": "741c219db523cb51d4cdf35723ce3bfc592fb74a"
}

The build_id returned in the API response is used to uniquely identify your test execution. Each test build is an execution of your XCUI test-suite on all selected devices.

Related topics

• Manage your uploaded app or test suite using our upload app REST API and upload test suite REST API.

• Use the get app API endpoint and list test suites API endpoint to list your recently uploaded apps and test suites.

• Delete your uploaded app or test suite using the delete app API endpoint and delete test suite API endpoint.