Get Run Item By Id

Description

'Get Run Item By Id' endpoint returns detailed information about a run of a flow in a schedule. The run of the flow (RunItem) is identified by the Id of the run item.

Run Item ID can be fetched from Response Body of Get Run Items Id by Run Id endpoint.

Request URL

http://{controllerMachine}:{controllerPort}/api/v3/runItems/{runItemId}

Input parameters

Field Type Description Comment
runItemId string The runItemId is a unique Id for the individual run instance of a flow in a run runItemId can be fetched from Response Body of Get Run Items Id by Run Id endpoint

Examples

Curl

curl -X GET --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' 'http://{controllerMachine}:{controllerPort}/api/v3/runItems/28519a47-7c28-425f-9d6f-5eeab722166e'

PowerShell 

$headers = @{}

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

Invoke-WebRequest -Uri "http://{controllerMachine}:{controllerPort}/api/v3/runItems/28519a47-7c28-425f-9d6f-5eeab722166e" -ContentType "application/json" -Headers $headers -Method GET

Response

 

{
    "$id": "1",
    "RunItemId": "8d329bd0-698f-4900-8bad-ffa584d4461b",
    "RunId": "a3af0714-444c-44bd-ac0b-10a12bd0e44a",
    "FlowInfo": {
        "FlowId": "793602fa-3131-4844-930e-52af8635dcff",
        "FlowTitle": "Password Reset Test",
        "Status": "Pass"
      },
    "EnvironmentInfo": {
        "EnvironmentId": "7dbf7cb6-d5df-4f46-8e16-9bd31238c00a",
        "EnvironmentTitle": "Remote Agent",
        "ConnectionType": "RemoteAgent"
      },
    "Elapsed": "00:00:24.9951204",
    "ElapsedMilliseconds": 24995.1204,
    "ElapsedSeconds": 24.995120399999998                                                                                                                                    "CreatedAt": "2020-03-26T13:35:45.4314608+00:00",                                                                                                                "RunType": "Manual"
}

 

Response object 

Fields Type Description Values
$id string ID of internal object  
runItemId string ID of Run Item  
RunId string ID of Run  
FlowInfo FlowIntegrationInfo    
FlowIntegrationInfo Object Object holds values for FlowIntegrationInfo  
FlowId string Id of the flow  
FlowTitle string Title of the flow  
Status string Status of execution 'NoStatus', 'Initializing', 'Connecting', 'Connected', 'Running', 'Passed', 'Failed', 'Timeout', 'Inconclusive', 'Cancelled', 'Error', 'Done'
EnvironmentInfo EnvironmentIntegrationInfo    
EnvironmentIntegrationInfo Object Object holds values for EnvironmentIntegrationInfo  
EnvironmentId string Id of the execution environment  
EnvironmentTitle string Title of the execution environment  
ConnectionType string Type of the execution environment 'RemoteAgent', 'Local', 'SauceLabs', 'SeleniumGrid', 'BrowserStack'
Elapsed string Total time of flow execution  
ElapsedMilliseconds number Total time of flow execution in milliseconds  
ElapsedSeconds number Total time of flow execution in seconds  
Timestamp datetime Time stamp  
Status string Run output Error/Pass/Fail  

 

Response Code

 

200 (OK)

404 (Not Found)

401 (Unauthorized)

400 (Bad Request)

405 (Method Not Allowed)

500 (Internal Server Error)