For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content
Execute Test (Espresso/XCUI)›Execute espresso test on the LambdaTest platform (Server 3)
TestMu AI
StatusCommunityBlog
Selenium Automation API
Automated Screenshots API
App Automation API (Real Devices)
Smart UI
Cypress Automation
User Management
Test Manager
HyperExecute
Accessibility Testing
Analytics
Performance Testing
Audit logs
Execute Test (Espresso/XCUI)

Execute espresso test on the LambdaTest platform (Server 3)

This endpoint enables you to execute automated tests using the LambdaTest platform.

POST
/framework/v1/espresso/build
Execute espresso test on the LambdaTest platform (Server 3)
curl --request POST \
  --url "https://manual-api.lambdatest.com/framework/v1/espresso/build" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "app": "<app>",
    "testSuite": "<testSuite>",
    "device": [],
    "queueTimeout": 0,
    "idleTimeout": 0,
    "deviceLog": true,
    "network": true,
    "build": "<build>",
    "geoLocation": "<geoLocation>"
  }'
{
  "status": [
    "Success"
  ],
  "buildId": [
    "1395514"
  ],
  "message": [
    ""
  ]
}

Authorizations

Authorizationstringheaderrequired

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
appstringrequired

The APPID of the uploaded app, usually in the format 'lt://APP_ID'.

testSuitestringrequired

The ID of the uploaded test suite to be executed, usually in the format 'lt://TestSuite_ID'.

devicearrayrequired

List of device identifiers where the test should be executed. e.g., ['Galaxy S21 5G-12', 'iPhone 12'].

queueTimeoutintegerrequired

Maximum time in seconds to wait for devices to be available in the queue. Defaults to 10800 seconds (3 hours).

idleTimeoutintegerrequired

Maximum idle time in seconds before a running test is terminated. Defaults to 150 seconds.

deviceLogbooleanrequired

Enable or disable device log capturing. Defaults to true.

networkbooleanrequired

Enable or disable network log capturing. Defaults to false.

buildstringrequired

Name of the build for identification purposes.

geoLocationstring

Geo-location setting for the test, specified as a country code. Defaults to 'US'.

Response

application/json

Successful operation

statusarray
buildIdarray
messagearray
Execute espresso test on the LambdaTest platform (Server 3)
curl --request POST \
  --url "https://manual-api.lambdatest.com/framework/v1/espresso/build" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "app": "<app>",
    "testSuite": "<testSuite>",
    "device": [],
    "queueTimeout": 0,
    "idleTimeout": 0,
    "deviceLog": true,
    "network": true,
    "build": "<build>",
    "geoLocation": "<geoLocation>"
  }'
{
  "status": [
    "Success"
  ],
  "buildId": [
    "1395514"
  ],
  "message": [
    ""
  ]
}