SessionEnforcementStateOutput

  • applicationId
    Type: stringFormat: uuid
    required
  • authority
    Type: "LEGACY_BACKEND" or "PLATFORM"enum
    required
  • caliperSessionId
    Type: string
    required
  • lockout
    Type: nullable
    required

    Persisted proctoring lockout record with audit fields

    Properties: 17
  • notifications
    Type:
    required
    Properties: 11
  • organizationId
    Type: stringFormat: uuid
    required
  • requiredAction
    Type: "NONE" or "RESUME" or "END_SESSION"enum
    required
  • sessionContext
    Type: "UNKNOWN" or "STANDARD" or "PROCTORED"enum
    required

    The pinned mode of this session. Carries no consequence meaning on its own — read each notification's presentationVariant for that. UNKNOWN means the mode never reconciled, and such a session never accrues consequence. PROCTORED alone does not enforce: accrual also requires authority PLATFORM (see the authority field). A LEGACY_BACKEND proctored session returns PROCTORED with no strikes and INFO notifications.

  • signalOutcomes
    Type:
    required
    Properties: 4
  • strikes
    Type:
    required
    Properties: 5
  • userId
    Type: stringFormat: uuid
    required
  • authorityError
    Type: object | null

    Typed authority failure. INVALID_PAYLOAD is retryable (true) and distinct from INVALID_ARGUMENT. INVALID_ARGUMENT is not retryable.

    Properties: 3
  • authorityPendingReason
    Type: string | null

    Nonblank when notificationAuthorityState is PENDING_CONTEXT.

  • authorityUnavailableReason
    Type: string | null

    Nonblank when notificationAuthorityState is UNAVAILABLE.

  • currentPresentation
    Type: nullable

    The single live presentation for this session's open incident, or null. Only present for contract version 2 sessions.

    Properties: 15
  • lockoutPresentation
    Type: nullable

    The blocked-relaunch presentation for the current launch attempt, or null. Only present for contract version 2 sessions.

    Properties: 8
  • notificationAuthorityState
    Type: stringenum

    Whether the returned notification state is authoritative right now. PENDING_CONTEXT means the authorizing source cursor has not been received for this session, the source is UNAVAILABLE, required facts declared by the producer are not yet durable, or the authorizing VISION horizon has not yet reached the evidence — so the client retries rather than treating the absent presentation as "nothing to show". It does not depend on how recently the producer last published.

    values
    CURRENTPENDING_CONTEXTINVALID_REQUESTUNAVAILABLE
  • notificationContractVersion
    Type: 1 or 2enum

    The contract pinned when this session initialized. Absent or null means the pin is still pending — never treat as version 1. Immutable once pinned for the lifetime of the session.

  • notificationRevision
    Type: integer | null
    min:  
    0

    Monotonic session notification revision for the committed poll snapshot. Null for PENDING_CONTEXT/UNAVAILABLE when the frozen transport omits it.

  • serverTime
    Type: stringFormat: date-time

    Platform evaluation time for the poll snapshot.

Previous
LockoutPresentationOutput
Next
PaginatedSessionsOutput