> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talview.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Instance Updated

> Triggered when a proctoring session is updated, for example when its status changes or it is scored.

> [!NOTE]
>
> For general webhook concepts like bubble-up behavior, payload visibility rules, and versioned snapshots, see [Webhook Concepts](https://docs.talview.com/graph-api-reference/webhooks/concepts.md).

## 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

* **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`](https://docs.talview.com/graph-api-reference/webhooks/proctoring/session/instance-created), [`incident.instance.created`](https://docs.talview.com/graph-api-reference/webhooks/proctoring/incident/instance-created)

## Trigger

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

## Payload Example

```json theme={null}
{
  "id": 2523,
  "uuid": "019c22ef-edc6-765d-9ab3-c2acf41b5253",
  "status": "COMPLETED",
  "integrity": "NEEDS_REVIEW",
  "duration": 3600,
  "score": 0.62,
  "summary": [
    {
      "type": "paragraph",
      "content": [
        {
          "type": "text",
          "text": "Unauthorized application detected in the background."
        }
      ]
    }
  ],
  "url": "https://exam.example.com/attempt/789",
  "flow_config_id": 12,
  "chat_channel_id": 4410,
  "external_id": "attempt_789",
  "fingerprint_hash": "9f2c1d7a3b5e",
  "tenant_id": 300,
  "created_at": "2026-02-03T09:57:55.341Z",
  "created_by": 1,
  "updated_at": "2026-02-03T10:58:01.117Z",
  "updated_by": 1,
  "timelines": [
    {
      "id": 263653,
      "event_type": "CONSENT_PAGE_SHOWN",
      "event_trigger_at": "2026-02-03T09:58:10.444Z",
      "created_at": "2026-02-03T09:58:09.330Z"
    }
  ],
  "idv_requests": []
}
```

## Payload Type Showcase

```typescript theme={null}
{
  id: number;
  uuid: string;
  status: string;
  integrity: string | null;
  duration: number | null;
  score: number | null;
  summary: object[] | null;
  url: string | null;
  flow_config_id: number | null;
  chat_channel_id: number | null;
  external_id: string | null;
  fingerprint_hash: string | null;
  tenant_id: number;
  created_at: string;
  created_by: number;
  updated_at: string;
  updated_by: number;
  timelines: {
    id: number;
    event_type: string;
    event_trigger_at: string;
    created_at: string;
  }[];
  idv_requests: {
    id: number;
    idv_request_id: string;
    session_instance_id: number;
    created_at: string;
  }[];
}
```

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.