VocalDocscontracts 1.65.0

ProcessInstance

A Process instance (1.62.0, ADR 0039): one durable execution of a published process-scope Workflow version, with its status, where it waits and who started it. Identifiers, codes and instants, and its content only on include=content.

An object with 22 fields.

Fields

FieldTypeRequiredDescription
compliance_profile_versioninteger or nullyesThe Compliance profile version pinned at the start (section 10, rule 3).
correlatedbooleanyesTrue when the instance has a correlation key, which Process events match on; the key is kept as a keyed hash and never answered.
current_nodesarray of WorkflowNodeIdyesThe nodes the instance is at; empty once it ended.
ended_atTimestamp or nullyes
environmentEnvironmentyes
error_codestring or nullyesWhy a failed instance failed, such as max_steps_reached, max_lifetime_reached or the failure code of the node that ended it failed; null otherwise.
idProcessInstanceIdyes
inputsobject or nullyesThe start inputs. Content; null unless the read names include=content.
interpreter_versionstringyesThe version of Vocal's interpreter the instance pinned at its start, kept by the runner until the instance ends.
object"process"yes
organization_idOrganizationIdyes
outputsobject or nullyesThe declared outputs, once the instance ended on an end node. Content; null unless the read names include=content.
project_idProjectId or nullyesThe instance's Project: the default Project until Projects ship.
started_atTimestampyes
started_byProcessStartedByyes
statusProcessInstanceStatusyes
updated_atTimestampyes
varsobject or nullyesThe working data. Content; null unless the read names include=content.
waiting_onProcessWaitingOn or nullyes
wake_atTimestamp or nullyesThe next timer of a waiting instance, mirrored from the runner; null when none.
workflow_idWorkflowIdyes
workflow_versionintegeryesThe process-scope Workflow version the instance runs to its end (section 10).

Used by

The operations whose parameters, request body or responses name this shape directly.