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 fromIN_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
- Subscription Key:
session.instance.updated - Use Case: Follow a session through its lifecycle, or retrieve the score and integrity once the session completes.
- Related Events:
session.instance.created,incident.instance.created
Trigger
- Event Type:
session_instance_updated - Source: Update of a record in the
session.instancetable.
Payload Example
Payload Type Showcase
Field Notes
statusis one ofCREATED,IN_PROGRESS,PAUSED,STOPPED,SUSPENDED,COMPLETED,TERMINATED.integrityis one ofHIGH,NEEDS_REVIEW,LOW, ornulluntil the session has been assessed.scoreis the session’s Proview Index (shown as “risk” in v8): a 0-1 score from the frequency and severity of incidents.summaryis the AI-generated session summary as rich-text blocks, ornulluntil one is produced.external_idis theidentifieryou supplied when the session was created.durationis the session length in seconds.urlis the page origin captured when the session started. It is not a recording link.timelineslists the session’s chronological events, excluding deleted ones.idv_requestslists the identity-verification requests linked to the session, excluding deleted ones.- Compare
statuswith the value from your last delivery to detect a transition.

