workflowManager.workflowSession.updated

workflowManager.workflowSession.updated

When a workflow entry is completed (by the driver or automatically by the workflow parser), an answer is added to the list of answers in the workflow session.

Payload json

{
  "eventBatchId": "a1b2c3d4-0000-0000-0000-000000000001",
  "eventSubscriptionId": "a1b2c3d4-0000-0000-0000-000000000002",
  "eventBatchTime": "2026-05-20T09:00:00.0000000Z",
  "eventsData": [
    {
      "eventType": "workflowSession.updated",
      "eventVersion": 1,
      "eventData": {
        "answers": [
          {
            "feedbackIndex": 0,
            "entryId": 1001,
            "location": {
              "longitude": 4.9041,
              "latitude": 52.3676,
              "validity": "valid"
            },
            "value": "Yes",
            "registeredOn": "2026-05-20T09:00:00Z",
            "reportCodes": [
              {
                "reportCode": "anomaly",
                "integratorCode": "sample"
              }
            ],
            "tags": {
              "key": "value"
            }
          }
        ],
        "workflowSessionId": "a1b2c3d4-0000-0000-0000-000000000001",
        "workflowId": "a1b2c3d4-0000-0000-0000-000000000002",
        "driverId": "a1b2c3d4-0000-0000-0000-000000000003",
        "assetId": "a1b2c3d4-0000-0000-0000-000000000004",
        "startTime": "2026-05-20T09:00:00Z",
        "reportCodes": [
          {
            "reportCode": "anomaly",
            "integratorCode": "sample"
          }
        ],
        "tags": {
          "key": "value"
        },
        "status": "inProgress",
        "organizationId": "a1b2c3d4-0000-0000-0000-000000000005",
        "registeredOn": "2026-05-20T09:00:00Z",
        "eventId": "a1b2c3d4-0000-0000-0000-000000000006",
        "occurredOn": "2026-05-20T09:00:00Z"
      }
    }
  ]
}

Field level Description

FieldTypeDescription
WorkflowSessionIdGuidUnique identifier of the workflow session.
WorkflowIdGuidUnique identifier of the workflow this session belongs to.
DriverIdGuid?Unique identifier of the driver. Omitted from the payload when null (WhoSeesWhat filtering may also null this field).
AssetIdGuidUnique identifier of the asset linked to this session.
StartTimeDateTimeUTC timestamp when the workflow session started.
ReportCodesList<ReportCodeInfo>List of report codes associated with this session.
TagsDictionary<String, String>Key-value pairs of custom metadata tags attached to the session.
StatusStringCurrent feedback status of the session (inProgress, finished, cancelled).
AnswersList<WorkflowEntryFeedback>List of answer entries collected during the session at the time of the update.

ReportCodeInfo

FieldTypeDescription
ReportCodeStringThe standardized report code type.
IntegratorCodeStringOptional custom code provided by the integrator. Omitted when null.

WorkflowEntryFeedback

FieldTypeDescription
FeedbackIndexInt32Zero-based index of this feedback entry within the workflow form.
EntryIdInt64Unique identifier of the form entry definition.
LocationCoordinateGPS coordinate recorded at the time of this feedback entry.
ValueStringThe answer value submitted for this entry.
RegisteredOnDateTimeUTC timestamp when this feedback entry was submitted.
ReportCodesList<ReportCodeInfo>Report codes associated with this specific feedback entry.
TagsDictionary<String, String>Key-value metadata tags specific to this feedback entry.

Did this page help you?