The Scenario Run object - Texterchat

very time a subscription’s trigger event fires, a run is recorded: whether conditions matched, whether the webhook action succeeded, and per-step timing and errors. Query runs with List Scenario Runs to debug a subscription that “doesn’t fire”.

Returned by: List Scenario Runs

Example scenario run object

{
  "_id": "6970c4d5e6f70123456789ab",
  "scenarioId": "6970b3c1d2e3f40123456789",
  "version": 1,
  "success": true,
  "started": 1768314807488,
  "executionTime": 312,
  "conditionsResult": true,
  "steps": [
    {
      "type": "event",
      "name": "domain.message.created",
      "executionTime": 2
    },
    {
      "type": "condition",
      "name": "filtrex",
      "groupIndex": 0,
      "index": 0,
      "result": true,
      "executionTime": 1
    },
    {
      "type": "loader",
      "name": "chat",
      "position": "afterConditions",
      "index": 0,
      "executionTime": 48
    },
    {
      "type": "action",
      "name": "request",
      "index": 0,
      "executionTime": 260
    }
  ]
}

Top-level

Field	Type	Description
`_id`	`string`	ID of the run record
`scenarioId`	`string`	The scenario (subscription) that ran
`version`	`number`	Revision version that ran
`success`	`boolean`	Whether the run completed without errors
`started`	`number`	Run start time (epoch ms)
`executionTime`	`number`	Total execution time in milliseconds
`conditionsResult`	`boolean`	Overall conditions outcome. `false` = the event fired but conditions filtered it out, so actions did not run

Steps

Each item of steps[] records one executed component. Common fields plus per-type extras:

Field	Type	Description
`type`	`string`	`event`, `loader`, `condition`, `action`, `loop`
`name`	`string`	Component name (e.g. `domain.message.created`, `chat`, `filtrex`, `request`)
`executionTime`	`number`	Step duration in milliseconds
`error`	`string`	Error message, when the step failed
`result`	`boolean`	Conditions only: whether this condition passed
`groupIndex / index`	`number`	Position of the condition/loader/action within the revision definition
`position`	`string`	Loaders only: `beforeConditions` / `afterConditions`
`output`	`any`	Actions only: the action result (e.g. webhook response), when recorded
`iterations`	`object[]`	Loops only: sub-run results, each with its own `success` / `steps` / `executionTime`