Re-Run

Description

The 'Re-Run' endpoint re-triggers a schedule identified by the runId. The response is a new runId, which is a unique value for the specific run.

The initial runId is typically generated from the Run Schedule Now endpoint, which is then used to rerun the same schedule.

This endpoint can be used to run a schedule with the exact same versions of flows, sub-flows etc. as the original run of the schedule. From a DevOps perspective, this can be used to run the exact same version of flows (test cases) against different versions of the code base, regardless of any changes made to the flows in the mean time.

Examples

http://{controllerMachine}:{controllerPort}/api/v4/run/39f2b3e3-fa24-43e7-a2d6-38815128ac6c/reRun/d96dd00f-eb82-4aac-9e5c-e88dac58b50e?var1=val1&var2=val2   

In this example, the RunId and AgentId are added as part of the endpoint URL. The value of ‘var1’ and ‘var2’ will be set to ‘val1’ and ‘val2’ respectively, if the variables are defined in the schedule configuration. The schedule variables can be used dynamically in the automation flows, so this is a method to input values and parameters directly to the individual automation flows via the schedule.

A real-life example of this is to trigger a schedule with the URL of the website that the automation flow should use in the execution. Creating a URL variable in the schedule and assigning different values for the URL will trigger the flows on different websites.

To understand more about using scheduled variables, please see this blog post: https://www.leapwork.com/services/learning-center/running-same-test-case-in-multiple-environments.

Request URL

http://{controllerMachine}:{controllerPort}/api/v4/run/{runId}/reRun/{agentId}

Input parameters

Property Type Description Comments
runId string The runId is a unique Id for the individual run instance of a schedule. The runId can be fetched from the response body of the Run Schedule Now endpoint.
agentId string The agentId is a unique Id for the individual agent. The agentId can be fetched from the response body of the Get All Agents endpoint. It is an optional field.

Examples

Curl

curl -X PUT --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' 'http:// {controllerMachine}:{controllerPort} /api/v4/run/39f2b3e3-fa24-43e7-a2d6-38815128ac6c/rerun/d96dd00f-eb82-4aac-9e5c-e88dac58b50e'

PowerShell 

$headers = @{}

$headers.Add("AccessKey","Mo87Nc4qDAtzJNDb")

$runID="39f2b3e3-fa24-43e7-a2d6-38815128ac6c"

$agentID= "d96dd00f-eb82-4aac-9e5c-e88dac58b50e"

Invoke-WebRequest -Uri "http://{controllerMachine}:{controllerPort}/api/v4/run/$runID/reRun/$agentID" -ContentType "application/json" -Headers $headers -Method PUT 

Response

RunId of a run is returned in this response.

{
"$id": "1",
"RunId": "da6845c9-ae69-45d3-b100-795a3b866623"
}

 

Response object

Field Type Description Comments
runId string The runId is a unique Id for the individual run instance of a schedule. runId can be used to fetch information about execution output of flows defined in a schedule.

Response Code

200 (OK)

404 (Not Found)

401 (Unauthorized)

400 (Bad Request)

405 (Method Not Allowed)

500 (Internal Server Error)