Skip to content
StartupBuilder
by startups.studio
by Startups.Studio
Business
Changelog
Events

Action.failed

An Action stopped with an error before it finished; a retry is a new Action.

PropertyValue
Raised byNo Verb: the runtime raises it
NounAction
MovesAction pending to failed
WakesNone.

Payload

Each delivery is an Event record. data holds the Action as it stands, and previous holds the state it left.

FieldTypeRequiredDescription
namestringrequiredAction.failed.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.actionActionrequiredThe Action as the change left it.
data.action.statusstringrequiredOne of pending, done, failed, canceled, or refused.
data.action.reasonstringWhy a pending Action waits: queued, running, retrying, awaitingWorker, awaitingInput, awaitingSource, awaitingAction, or awaitingTime.
data.action.modestringrequiredHow the caller invoked it: try, send, or do.
data.action.byWorkerThe Worker that performed it.
data.action.forPartyThe Party it was done on behalf of.
data.action.viastringThe Interface or request it arrived through.
data.action.onstringThe Action or Event that caused it, such as the failed attempt a retry follows.
data.action.thingstringThe record, at the Version the Action was decided against.
data.action.inputjsonThe input it was called with.
data.action.createdAtdatetimeWhen it was called.
data.action.reservedmoneyThe most this Action may cost, held against its Limits from the check until it settles, billed misses included.
data.errorstringrequiredThe error it stopped with; its page gives the fix.
data.previous.statusstringrequiredThe status before this Event: pending.

Example

JSON
{
  "$id": "https://api.sb/leaseline.app/events/evt_uhWzorjhqr",
  "$type": "Event",
  "name": "Action.failed",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "action": {
      "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
      "$type": "Action",
      "status": "failed",
      "reason": "queued",
      "mode": "try",
      "by": "worker_whZFpOKWIV",
      "for": "party_hmQWaPrAyZ",
      "via": "API",
      "on": "Invoice.overdue",
      "thing": "inv_9sfvgeRT7L@v3",
      "input": {},
      "createdAt": "2026-10-22T12:00:00Z",
      "reserved": {
        "amount": 29,
        "currency": "USD"
      }
    },
    "error": "conflict",
    "previous": {
      "status": "pending"
    }
  },
  "seq": 2398
}