ProcessUpdatedSummary
What the tenant-wide process-updated event carries: a short summary of any run in the tenant that changed, the same shape for all four kinds of run. It never includes a run’s conversation, steps, output or inputs; fetch the run when you need them.
schemaVersion goes up only for a change an existing reader would misread; new fields can appear without it. Ignore fields you don’t know.
Kind: an object, used in responses.
Fields
Section titled “Fields”Every field is present in a response; empty ones are null.
| Field | Type | Description |
|---|---|---|
schemaVersion | integer | The version of this shape, currently 1. |
type | ProcessType | The kind of run. |
id | uuid | The run’s id. |
tenantId | uuid | The run’s tenant. |
status | string | The run’s status, as its kind names it (such as Running). |
state | ProcessState | Which group the status falls into. |
definitionId | uuid | null | The id of the interaction, app, capsule or code pipeline the run was started from. |
definitionVersion | integer | null | The version of the definition the run was started from. |
dateCreated | datetime | null | When the run was created, in UTC. |
dateStarted | datetime | null | When the run started, in UTC. |
dateEnded | datetime | null | When the run ended, in UTC; null while it is live. |
dateUpdated | datetime | When the run last changed, in UTC. |
parentProcessId | uuid | null | The id of the run that started this one, or null. |
parentProcessType | ProcessType| null | The kind of run parentProcessId is. |
rootProcessId | uuid | null | The id of the run at the top of this run’s tree. |
userCreatedById | uuid | null | The id of the user who started the run. |
awaitingHumanInput | boolean | Whether the run is waiting for a person: an answer, a message or an approval. |
failureSummary | string | null | A short summary of what went wrong, at most 300 characters; null when nothing did. |
Example
Section titled “Example”{ "schemaVersion": 0, "type": "App", "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "status": "...", "state": "Active", "definitionId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "definitionVersion": 0, "dateCreated": "2026-10-26T12:00:00.0000000Z", "dateStarted": "2026-10-26T12:00:00.0000000Z", "dateEnded": "2026-10-26T12:00:00.0000000Z", "dateUpdated": "2026-10-26T12:00:00.0000000Z", "parentProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "parentProcessType": "App", "rootProcessId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "userCreatedById": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f", "awaitingHumanInput": false, "failureSummary": "..."}