List

Description

Retrieve a list of actions available in the Tines tenant. With change control enabled when getting actions for a specific story the story_mode defaults to LIVE.

Request

HTTP Method: GET

Parameter Description
story_id Optional List actions for the given story
story_mode Optional List actions for the given story mode (must be used with story_id)
team_id Optional List actions for the given team
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/actions \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request will return a JSON Array describing actions in the Tines tenant.

Field description

Parameter Description
id Action ID.
type Action type
user_id User ID of the action's owner.
options JSON Options block of the action.
name Name of the action.
description A user-defined description of the action.
schedule An object defining the cron schedule for the action.
blended_events_count Number of events action has emitted in both TEST and LIVE mode.
logs_count Number of logs action has stored.
last_check_at ISO 8601 Timestamp representing date and time of action's last scheduled run.
last_receive_at ISO 8601 Timestamp representing date and time of last event received.
created_at ISO 8601 Timestamp representing creation date and time of action.
updated_at ISO 8601 Timestamp representing last updated date and time of action.
last_event_at ISO 8601 Timestamp representing date and time the last event was received.
last_error_log_at ISO 8601 Timestamp representing date and time of last error thrown by the action.
disabled Boolean flag indicating whether action is disabled.
guid Unique identifier of the action.
position An object describing the XY coordinates of the action on the story diagram.
story_id ID of story to which the action belongs.
story_mode Mode of the story to which the action belongs LIVE or TEST
team_id ID of story to which the action belongs.
sources An Array of Action IDs this action receives emitted events from.
receivers An Array of Action IDs this action emits events to.
monitor_failures Boolean flag indicating if a notification should be sent when this action fails.
monitor_all_events Boolean flag indicating if all events should be monitored.
monitor_no_events_emitted Duration in seconds. If no events are emitted in this time, a notification will be sent.
time_saved_unit Unit of time corresponding to time saved value.
time_saved_value Number indicating the amount of time saved.
page An object with information on the associated page, if this is a page action

Sample response

{
  "agents": [
    {
      "id": 73563,
      "type": "Agents::EventTransformationAgent",
      "user_id": 167,
      "options": {
        "mode": "deduplicate",
        "path": "{{.propagation_webhook.password}}",
        "lookback": "1"
      },
      "name": "Deduplicate",
      "schedule": [
        {
          "cron": "*/1 * * * *",
          "timezone": "Europe/Dublin"
        }
      ],
      "blended_events_count": 2,
      "logs_count": 4,
      "last_check_at": "2021-05-07T11:46:50Z",
      "last_receive_at": "2021-05-07T11:46:50Z",
      "created_at": "2021-05-07T11:42:58Z",
      "updated_at": "2021-05-07T11:47:00Z",
      "last_event_at": "2021-05-07T11:47:00Z",
      "last_error_log_at": null,
      "disabled": false,
      "guid": "f3fe6f8e167c9db42e64eaef8e5d2f0c",
      "position": {
        "x": -945,
        "y": 450
      },
      "receivers": [70118],
      "sources": [70116],
      "story_id": 807,
      "story_mode": "LIVE",
      "team_id": 335,
      "monitor_failures": true,
      "monitor_all_events": true,
      "monitor_no_events_emitted": 86400,
      "time_saved_unit": "minutes",
      "time_saved_value": 10,
      "page": null
    }
  ],
  "meta": {
    "current_page": "https://<<META.tenant.domain>>/api/v1/actions?per_page=20&page=1",
    "previous_page": null,
    "next_page": null,
    "per_page": 20,
    "pages": 1,
    "count": 1
  }
}
Was this helpful?