Description

Use a HTTP POST request to create an action.

Request

HTTP Method: POST

Parameter Description
type Type of action to create:
Agents::EmailAgent
Agents::EventTransformationAgent
Agents::HTTPRequestAgent
Agents::IMAPAgent
Agents::TriggerAgent
Agents::WebhookAgent
Agents::SendToStoryAgent
name Name of the action.
options JSON Options block of the action.
position An object describing the XY coordinates of the action on the story diagram.
disabled Boolean flag indicating whether action is disabled.
story_id ID of story to which the action should be added.
source_ids Array of action IDs the action should receive emitted events from.
receiver_ids Array of action IDs the action should emit events to.
schedule An object defining the cron schedule for the action.

Sample request

curl -X POST \
  https://<tenant-name>.tines.io/api/v1/agents/<action-id> \
  -H 'content-type: application/json' \
  -H 'x-user-email: <email-address>' \
  -H 'x-user-token: <api-token>'
  -d '{
        "type":"Agents::EventTransformationAgent",
        "name": "Extract email addresses and urls",
        "story_id":1,
        "source_ids": [100, 102],
        "receiver_ids":[],
        "position": {"x": 100, "y": 200},
        "options":{
          "mode": "extract",
          "matchers": [
            {
              "path": "{{.text}}",
              "regexp": "\\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,4}\\b",
              "to": "email_addresses"
            },
            {
              "path": "{{.text}}",
              "regexp": "https?:\\/\\/[\\S]+",
              "to": "urls"
            }
          ],
          "message": "This is an optional message"
        }
      }'

Response

A successful request will return a JSON object describing the created action.

Field description

Parameter Description
id Action ID.
user_id User ID of the action’s owner.
options JSON Options block of the action.
name Name of the action.
schedule An object defining the cron schedule for the action.
events_count Number of events action has emitted.
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.
team_id ID of story to which the action belongs.
sources An Array of objects describing actions this action receives emitted events from.
receivers An Array of objects describing actions this action should emit 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.

Sample response

{
  "id": 73563,
  "user_id": 167,
  "options": {
    "mode": "deduplicate",
    "path": "{{.propagation_webhook.password}}",
    "lookback": "1"
  },
  "name": "Deduplicate",
  "schedule": [
    {
      "cron": "*/1 * * * *",
      "timezone": "Europe/Dublin"
    }
  ],
  "events_count": 2,
  "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": [
    {
      "id": 70118
    }
  ],
  "sources": [
    {
      "id": 70116
    }
  ],
  "story_id": 807,
  "team_id": 335,
  "monitor_failures": true,
  "monitor_all_events": true,
  "monitor_no_events_emitted": 86400
}