Execute Partial Test Plan Run via API


Performing a partial run in a test plan via an API call in Testsigma enables you to execute specific test suites and apply filters programmatically, providing flexibility and automation in your testing workflow. This documentation will guide you through configuring a partial test plan run, executing it via an API call, and scheduling the partial run for future execution.


Prerequisites

Before you begin, ensure that you have referred to:

  1. Documentation on creating test plans.
  2. Documentation on creating API key for authorization.
  3. Documentation on getting test plan ID.

Configure Partial Test Plan Run

Follow these steps to configure a partial test plan run.

  1. Open the Test Plan Details page for the Test Plan you want to configure a Partial Test Run for. Test plan
  2. Click the dropdown next to the Run Now button and select Partial Run. Partial Run
  3. In the Partial Test Plan Run overlay, configure your settings as needed. This includes selecting the Test Suites to include or exclude, applying filters based on specific criteria, and making any other necessary adjustments. configure
  4. Once you finalize the partial run configuration, click Save As Favorite. Save as favorite
  5. Enter a name for your favorite, then click Save. Click Save - PTPR
NOTE:

Remember the name used for the favorite configuration, as the API call will require it.


Partial Test Plan Run via API

Follow these steps to run the partial test plan via API call:

Request Type POST
Endpoint https://app.testsigma.com/api/v1/execution_results
Authorization Bearer Token → <API_Token>
Same as the Testsigma API key mentioned above.
Request Body Type (JSON) Raw
Payload {
  "executionId": "3857",
  "executionConfig": {
    "name": "fav_config_name"
  }
}
  • Find the execution ID of your test plan in the Test Plan details and replace 3857 with it.
  • Replace the name of the saved favorite configuration with fav_config_name.
NOTE:

Using the correct execution ID and favorite configuration name in the API call payload is essential to ensure accurate execution.


Configure Schedule Partial Test Plan Run

Follow these steps to schedule a partial test run for future execution.

  1. Open the Test Plan Details page for the Test Plan you want to configure a Schedule Partial Test Run for. Test plan
  2. Hover over the schedule icon and select Schedule Partial Run. Schedule Partial Run
  3. In the Schedule Partial Test Run overlay, configure your settings as needed. This includes entering a name, selecting the time, date, and repeat frequency, choosing the Test Suites to include or exclude, and applying any necessary filters or adjustments. Configure
  4. Once you finalize the configuration, click Save As Favorite. Save as Fav
  5. Enter a name for your favorite configuration, then click Save. Click Save - SPTPR
NOTE:

Remember the time, date, and name you used for the favorite configuration because the API call will require it.


Schedule Partial Test Plan Run via API

Follow these steps to schedule a partial test run via API call.

Request Type POST
Endpoint https://app.testsigma.com/api/v1/schedule_executions
Authorization Bearer Token → <API_Token>
Same as the Testsigma API key mentioned above.
Request Body Type (JSON) Raw
Payload {
    "name": "RandomTest3",
    "executionId": 3857,
    "scheduleType": "ONCE",
    "status": "ACTIVE",
    "nextInterval": "2023-06-01T17:30:00.000Z",
    "executionConfig": {
      "name": "fav_config_name"
    },
    "timezone": "IST"
}

Request Body Fields

  • name: You can set the name of the scheduled test run.
  • executionId: Replace 3857 with the execution ID of your test plan found in the Test Plan details.
  • scheduleType: Defines the type of schedule. In this example, it is set to ONCE to indicate a one-time execution.
  • status: Set the status of the scheduled test run to ACTIVE.
  • nextInterval: Modify the time value in the schedule section to specify the desired time for the partial test run execution. Use the ISO 8601 format, such as YYYY-MM-DDTHH:MM:SSZ.
  • executionConfig: Enter the name of the saved configuration in the executionConfig field. Replace fav_config_name with the name of the saved favorite configuration.
  • timezone: Specify the timezone for the scheduled execution.
NOTE:

Using the correct execution ID, desired time, and favorite configuration name in the API call payload is essential to ensure accurate execution.