Docs / Actions & workflows

Actions

A request can say what to do with its answers. Add an actions list: each action has a rule on the answers (when), what to do (slack, webhook or email, see Destinations) and the name of a connection. We answer the questions, run the rules, and deliver every action that fires.

{
  "model": "ora1",
  "state": {
    "symbol": "TSLA",
    "context": {
      "return_5d": 0.08,
      "volatility_20d": 0.55,
      "rsi_14": 71
    }
  },
  "questions": {
    "drop5": {
      "type": "yes_no",
      "instructions": "Will it drop at least 5% at some point in the next month?"
    }
  },
  "actions": [
    {
      "id": "desk_alert",
      "when": "drop5 >= 0.6",
      "do": "slack",
      "connection": "trading-desk",
      "message": "{{symbol}}: {{drop5|pct}} chance of a 5% drop this month"
    },
    {
      "id": "hedge",
      "when": "drop5 >= 0.75",
      "do": "webhook",
      "connection": "my-oms",
      "body": {
        "symbol": "{{symbol}}",
        "action": "buy_put",
        "p": "{{drop5}}"
      }
    },
    {
      "id": "all_clear",
      "when": "else",
      "do": "email",
      "connection": "me",
      "subject": "{{symbol}}: no alert"
    }
  ],
  "dry_run": true
}

The response adds what happened to each action:

{
  "actions": [
    {
      "id": "desk_alert",
      "fired": true,
      "status": "queued",
      "run_id": "act_9f2c…"
    },
    {
      "id": "hedge",
      "fired": false,
      "status": "skipped"
    },
    {
      "id": "all_clear",
      "fired": false,
      "status": "skipped"
    }
  ]
}

Delivery is asynchronous and retried 3 times (after 30 s, 2 min, 10 min) on network errors, 429 and 5xx. At most 10 actions per request. Requests never carry URLs, tokens or addresses: only connection names.