Upload XCUITest test suites for Apple TV

Package your test suite as a zip file that contains the Runner app and upload it to BrowserStack.

After you upload your tvOS app, upload the test suite containing your XCUITest test cases to BrowserStack servers using the REST API. tvOS test suites use the same upload endpoint as iOS test suites.

Test suite requirements

Your test suite must be a .zip file that contains the <Name>-Runner.app generated when you build your UI test target for tvOS.

Upload test suites from filesystem

To upload a test suite from your local filesystem or CI/CD server, use the following cURL example:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/test-suite" \
-F "file=@/path/to/test-suite/YourTVAppUITests.zip"

The API returns a response similar to the following:

{
    "test_suite_name":"YourTVAppUITests.zip",
    "test_suite_url":"bs://<hashed_test_suite_id>",
    "test_suite_id":"<hashed_test_suite_id>",
    "uploaded_at":"2026-11-03 06:17:50 UTC",
    "expiry":"2026-12-03 06:17:50 UTC",
    "framework":"xcuitest"
}

Note the value of test_suite_url in the API response. Use this value to specify the test suite when you execute your XCUITest tests.

Related topics

• Execute your XCUITest tests on Apple TV devices.
• List or delete your uploaded test suites using the XCUITest test suites REST API.