curl -g "https://YOUR_PROJECT.texterchat.com/server/api/v2/scenarios/runs?scenarioId=6970b3c1d2e3f40123456789&sortStarted=desc&limit=20" \
-H "Authorization: Bearer YOUR_API_TOKEN"{
"total": 1,
"runs": [
{
"_id": "6970c4d5e6f7a80123456789",
"scenarioId": "6970b3c1d2e3f40123456789",
"version": 1,
"triggerEvent": "domain.message.created",
"started": 1768315000000,
"executionTime": 84,
"success": true,
"conditionsResult": true,
"steps": [
{
"type": "action",
"name": "request",
"executionTime": 71,
"paramsIsValid": true,
"confidentialData": false
}
]
}
]
}{
"error": "<string>"
}List Scenario Runs
Retrieve execution records of your scenarios - useful for debugging webhook subscriptions: see whether the event fired, whether the conditions matched (conditionsResult), whether the webhook request succeeded (success), and per-step timings and errors.
curl -g "https://YOUR_PROJECT.texterchat.com/server/api/v2/scenarios/runs?scenarioId=6970b3c1d2e3f40123456789&sortStarted=desc&limit=20" \
-H "Authorization: Bearer YOUR_API_TOKEN"{
"total": 1,
"runs": [
{
"_id": "6970c4d5e6f7a80123456789",
"scenarioId": "6970b3c1d2e3f40123456789",
"version": 1,
"triggerEvent": "domain.message.created",
"started": 1768315000000,
"executionTime": 84,
"success": true,
"conditionsResult": true,
"steps": [
{
"type": "action",
"name": "request",
"executionTime": 71,
"paramsIsValid": true,
"confidentialData": false
}
]
}
]
}{
"error": "<string>"
}View scenarios runsAuthorizations
API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.
Query Parameters
Filter runs of a specific scenario (subscription)
Filter by revision version (1-100000)
^[0-9]+$Filter by run success
true, false Filter by overall conditions result
true, false Sort by start time
asc, desc Sort by execution time
asc, desc Maximum results to return (1-10000)
^[0-9]+$Results to skip (0-1000000)
^[0-9]+$Include runs of built-in system scenarios. Defaults to false
true, false Response
The matching runs and total count. Field-by-field reference: The Scenario Run object