Specify application under test

While executing your Espresso tests, you must specify the uploaded app to run your Espresso test cases on. In order to do so, you need to pass the app parameter in the REST API request to start your test execution. You can set its value in one of the following ways :

1. Using an app_url value: This is returned in the response to an app upload REST API request.
2. Using a custom_id value: This is the custom ID you defined in an app upload REST API request. By default, it will pick the last build of your uploaded app under the given custom ID.
3. Using a shareable_id value: This is returned in the response to an app upload REST API request. It enables other users in your organization to test an app you uploaded.

REST API endpoint :

POST /app-automate/espresso/v2/build

Example cURL requests :

Use a sample app_url to specify the application under test for your Espresso test execution :

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

Use sample custom_id to specify the application under test for your Espresso test execution :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/espresso/v2/build" \
-d '{"devices": ["Samsung Galaxy S8-7.0"], "app": "CalculatorApp", "testSuite": "CalculatorAppTest"}' \
-H "Content-Type: application/json"