---
title: "Get the Session Leaders grid for a peer_led cohort (MED-906)"
method: GET
path: "/api/cohorts/{cohortId}/sessions/leaders-grid"
tags: ["Sessions"]
---

# Get the Session Leaders grid for a peer_led cohort (MED-906)

`GET /api/cohorts/{cohortId}/sessions/leaders-grid`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/cohorts/{cohortId}/sessions/leaders-grid`
- Auth: HTTP bearer

Returns the rows-and-columns data backing the Session Leaders tab on
the cohort page. Available only for cohorts whose group_coaching
modality has coaching_sub_type='peer_led'. Gated by the
`live_session_delivery` feature flag.

Cells reflect the current `sessions.session_leader_id` value — manual
assignments made via `PUT /api/cohorts/:cohortId/sessions/:sessionId/leader`
(MED-812) appear here. The "Generate Rotation Order" algorithm is
deferred to a follow-up ticket.

## Path parameters

- `cohortId` string, uuid, required

## Response `200`

Grid response with groups (rows) and sessions (columns).

- object
  - `success` boolean
  - `data` object
    - `groups` object[]
      - `group_id` string, uuid
      - `name` string
      - `member_count` integer
      - `members` object[]
        - `user_id` string, uuid
        - `first_name` string
        - `last_name` string
    - `sessions` object[]
      - `session_id` string, uuid
      - `session_number` integer, nullable
      - `topic_name` string, nullable
      - `scheduled_start` string, date-time, nullable
      - `scheduled_end` string, date-time, nullable
      - `group_id` string, uuid
      - `leader` object, nullable
        - `user_id` string, uuid
        - `first_name` string
        - `last_name` string
        - `avatar_url` string, nullable

## Other responses

- `401`: Unauthorized
- `404`: Feature flag is off OR cohort has no group_coaching modality.
- `422`: Validation error. Possible `code` values: - `not_peer_led` — cohort's group_coaching modality is not peer_led

---

[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)