Skip to main content
For general webhook concepts like bubble-up behavior, payload visibility rules, and versioned snapshots, see Webhook Concepts.

Description

This event is triggered when a proctoring session instance changes, for example when its status moves from IN_PROGRESS to COMPLETED, or when its score, integrity or summary is set. It fires on every update to the record, so a single session produces many updated events over its lifetime.

Integration Details

Trigger

  • Event Type: session_instance_updated
  • Source: Update of a record in the session.instance table.

Payload Example

Payload Type Showcase

Field Notes

  • status is one of CREATED, IN_PROGRESS, PAUSED, STOPPED, SUSPENDED, COMPLETED, TERMINATED.
  • integrity is one of HIGH, NEEDS_REVIEW, LOW, or null until the session has been assessed.
  • score is the session’s Proview Index (shown as “risk” in v8): a 0-1 score from the frequency and severity of incidents.
  • summary is the AI-generated session summary as rich-text blocks, or null until one is produced.
  • external_id is the identifier you supplied when the session was created.
  • duration is the session length in seconds.
  • url is the page origin captured when the session started. It is not a recording link.
  • timelines lists the session’s chronological events, excluding deleted ones.
  • idv_requests lists the identity-verification requests linked to the session, excluding deleted ones.
  • Compare status with the value from your last delivery to detect a transition.