Status card - Soteris Developer Docs

A status card is a compact read model of an engagement, built for a quick answer rather than a full record. It is what a dashboard or an agent reads to know where things stand and what happens next.

Fields

Field	Meaning
`engagementId`	The engagement this card describes.
`lifecycleState`	The current public lifecycle state.
`blockers`	What, if anything, is preventing progress. An array of `code` and `label` pairs, partner-safe only.
`nextAction`	The next expected action, as an `actor` and `label` pair.
`owner`	The actor currently expected to act.
`updatedAt`	When the card was last refreshed.

Example

status-card.json

{
  "engagementId": "eng_9f2c",
  "lifecycleState": "document_gate_blocked",
  "blockers": [
    { "code": "missing_input", "label": "Bank statement required" }
  ],
  "nextAction": { "actor": "client", "label": "Submit the missing input" },
  "owner": "client",
  "updatedAt": "2026-01-16T09:25:00Z"
}

A status card reflects state. It does not change it, and nothing that writes back to it exists on a public surface. An agent should use the card to plan and to inform a human, then stop, per the Agent guide. The state values it can carry are defined in Public states.