---
title: "Mark the Step 3 (Preview / Sandbox) visited (AC11)"
method: POST
path: "/api/participant/sessions/{sessionId}/peer-leader-prep/step/3/visited"
tags: ["Peer Leader Session Prep"]
---

# Mark the Step 3 (Preview / Sandbox) visited (AC11)

`POST /api/participant/sessions/{sessionId}/peer-leader-prep/step/3/visited`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/participant/sessions/{sessionId}/peer-leader-prep/step/3/visited`
- Auth: HTTP bearer

Sets `peer_leader_session_prep.step3_visited_at = NOW()` the first
time the peer leader opens the preview. Idempotent: subsequent
visits leave the original timestamp in place. Drives the AC11
step-completion indicator for Step 3.

## Path parameters

- `sessionId` string, uuid, required

## Response `200`

Step 3 marker set; returns refreshed prep payload.

- object
  - `success` boolean
  - `data` PeerLeaderPrepPayload
    - `session` object
      - `id` string, uuid
      - `title` string, nullable
      - `session_number` integer, nullable
      - `scheduled_start` string, date-time, nullable
      - `scheduled_end` string, date-time, nullable
      - `duration_minutes` integer, nullable
      - `timezone` string, nullable
      - `cohort_id` string, uuid
      - `cohort_name` string, nullable
      - `program_name` string, nullable
      - `organization_name` string, nullable
      - `group_id` string, uuid, nullable
      - `group_name` string, nullable
      - `status` string
      - `ai_features_enabled` boolean: MED-816/MED-909 — cohort modality AI gate. When false all AI prep surfaces are absent.
      - `ai_listening_enabled` boolean: MED-909 AC4 — current AI Listening state for this session (read-only to the peer leader).
      - `ai_listening_locked` boolean: MED-909 AC4 — true once within 15 min of scheduled_start; the listening value is frozen.
    - `prep_status` 'unlocked' | 'locked' | 'live' | 'declined': `unlocked` happy path · `locked` preceding session not complete (AC3) · `live` session already launched (AC4) · `declined` leader declined RSVP (AC1).
    - `prep_locked_reason` string, nullable
    - `rsvp_status` 'unconfirmed' | 'confirmed' | 'declined'
    - `agenda` object, nullable: AuthoredAgendaForCoach payload from MED-976. Same shape coach prep uses.
    - `reflection_status` object, nullable: Reserved — currently always null; the FE derives Step 1 status from the existing reflection endpoint instead.
    - `prep_state` object
      - `marked_completed_at` string, date-time, nullable
      - `step2_reviewed_at` string, date-time, nullable
      - `step3_visited_at` string, date-time, nullable
      - `ai_prompt_selections` object: MED-909 AC1-AC2 — peer leader's In Use prompt selections JSONB, keyed by agenda block_key. Drives the AI suggestions banner count and per-step In Use badges. Empty object when none selected yet.
    - `is_first_time_leader` boolean
    - `cm_name` string, nullable

## Other responses

- `401`: Unauthenticated
- `403`: Caller is not the assigned session leader
- `404`: Session not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)