List runs

Description

Retrieve a list of group runs.

Request

HTTP Method: GET

Path Parameter Description
group_id The ID of the group.
Query Parameter Description
per_page Optional Set the number of results returned per page.
page Optional Specify the page of results to return if there are multiple pages. Defaults to page 1. 
curl -X GET \
 https://<<META.tenant.domain>>/api/v1/groups/<<group_id>>/runs \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request will return the JSON Array describing the group runs for a group.

Field description

Parameter Description
guid Guid of the group run.
duration Duration of the group run.
story_id ID of the parent story.
group_id ID of the group.
start_time The time the group run started.
end_time The time the group run ended.
action_count Number of actions in the run.
event_count Number of events in the run.
story_mode The mode of the parent story LIVE or TEST.

Sample response

{
  "group_runs": [
    {
      "guid": "5466f325-0bc6-47fb-943f-41d1a2a8d6ae",
      "duration": 0,
      "story_id": 155,
      "group_id": 200,
      "start_time": "2023-12-13T16:19:50Z",
      "end_time": "2023-12-13T16:19:50Z",
      "action_count": 5,
      "event_count": 5,
      "story_mode": "LIVE"
    },
    {
      "guid": "c0ea6684-1cfb-4ac5-858b-79c631daa79f",
      "duration": 0,
      "story_id": 155,
      "group_id": 200,
      "start_time": "2023-12-13T16:16:49Z",
      "end_time": "2023-12-13T16:16:49Z",
      "action_count": 1,
      "event_count": 1,
      "story_mode": "LIVE"
    }
  ],
  "meta": {
    "current_page": "https://<<META.tenant.domain>>/api/v1/groups/<<group_id>>/runs?per_page=20&page=1",
    "previous_page": null,
    "next_page": null,
    "per_page": 20,
    "pages": 1,
    "count": 2
  }
}
Was this helpful?