RevokeProctoringLockoutResponse

Wrapper response for lockout revocation; lockout is null when no active row matched.

  • lockout
    required

    Persisted proctoring lockout record with audit fields

    • dateCreated
      Type: string Format: date-time
      required

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • dateLastModified
      Type: string Format: date-time
      required

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • expiresAt
      Type: string Format: date-time
      required

      Computed server-side as startsAt + resolved lockoutDuration (seconds); never accepted from caller.

    • id
      Type: string Format: uuid
      required
    • lockoutStatus
      Type: string · LockoutStatusenum
      required

      Lockout lifecycle state

      values
      • active
      • expired
      • revoked
    • organizationId
      Type: string Format: uuid
      required
    • revokedAt
      Type: string | null Format: date-time
      required

      Set when the lockout was revoked (guide unlock or dispute release); null while active.

    • revokedByUserId
      Type: string | null Format: uuid
      required

      Platform user who revoked the lockout; null for system/dispute releases and while active.

    • revokeReason
      Type: string | null
      required

      Reason recorded at revoke time (e.g. guide_unlock, dispute_strike_release); null while active.

    • ruleSlug
      Type: string | null
      required

      Denormalized slug of the rule that tripped the lockout. Clients render lockout copy from this slug rather than fetching triggeringInsightId. Null when the lockout was created without a triggering rule.

    • scopeId
      Type: string | null Format: uuid
      required

      LtiApplication ID when scopeType='application'; null when scopeType='global'

    • scopeType
      Type: string · LockoutScopeTypeenum
      required

      Lockout scope discriminator

      values
      • application
      • global
    • startsAt
      Type: string Format: date-time
      required

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • triggeringCaliperSessionId
      Type: string | null
      required

      External Caliper session id of the triggering session, resolved from triggeringSessionId. Lets a consumer key a follow-up event (e.g. locked_out_restart) on the same external session id as the rest of the session's events. Null when the lockout has no triggering session or it is not yet materialized.

    • triggeringInsightId
      Type: string | null Format: uuid
      required
    • triggeringSessionId
      Type: string | null Format: uuid
      required

      Internal insights_session.id of the triggering session (audit pointer); not an external/Caliper id.

    • userId
      Type: string Format: uuid
      required