List live sessions

GET /api/v1/live-sessions

Lists the school's live sessions in agenda order: upcoming ones first, nearest first, then past ones, most recent first. A cancelled live stays in the list — it is what the targeted members see instead of the meeting.

Authorization

Role in the organization	This endpoint
`OWNER`	Allowed — every live of the school
`ADMIN`	Allowed — every live of the school
`MEMBER`	Conditional — only the lives that target one of the bearer's enrollments

Requirement	Rule for this endpoint
Business role	None — a coach sees the lives they are enrolled in, like anyone
Resource scope	The key's organization
Participation	For a `MEMBER`: an enrollment in the targeted cohort, in progress or completed
Resource state	None

Query parameters

Parameter	Type	Required	Description
`status`	string	no	`scheduled` or `cancelled`; all by default
`targetCohortId`	UUID	no	Only the lives targeting this cohort
`search`	string	no	Matches the title, up to 140 characters

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/live-sessions?status=scheduled" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the list, possibly empty.
400 Bad Request — an unknown status, or a cohort id that is not a UUID.
401 Unauthorized — missing, unknown or expired key.
403 Forbidden — the bearer is not a member of the school.

Response fields

Field	Type	Description
`data[].id`	UUID	Live session id
`data[].title` / `data[].description`	string	Title, and description or `null`
`data[].type`	string	`masterclass`, `workshop`, `qa`, `group_coaching` or `other`
`data[].status`	string	`scheduled` or `cancelled`
`data[].startsAt` / `data[].endsAt`	string	ISO 8601 instants
`data[].timezone`	string	IANA time zone the live was planned in
`data[].accessUrl`	string	Meeting link
`data[].provider`	string	`zoom`, `google_meet` or `other`
`data[].replayUrl`	string	Replay link, or `null`
`data[].hostUserId`	UUID	Host account, or `null`
`data[].targetType`	string	`cohort` — the only target open to scheduling
`data[].targetCohortId`	UUID	Targeted cohort, or `null`
`data[].targetCohortName`	string	Its name, or `null`
`data[].cancelledAt` / `data[].cancellationReason`	string	Set once cancelled
`data[].createdAt` / `data[].updatedAt`	string	ISO 8601

Example response

json

{
  "success": true,
  "data": [
    {
      "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
      "title": "Weekly Q&A",
      "description": "Bring your questions",
      "type": "qa",
      "status": "scheduled",
      "startsAt": "2026-10-08T17:00:00.000Z",
      "endsAt": "2026-10-08T18:00:00.000Z",
      "timezone": "Europe/Paris",
      "accessUrl": "https://meet.google.com/abc-defg-hij",
      "provider": "google_meet",
      "replayUrl": null,
      "hostUserId": null,
      "targetType": "cohort",
      "targetCohortId": "3a1f7c2e-5b6d-4e8f-9a0b-1c2d3e4f5a6b",
      "targetCohortName": "Autumn cohort",
      "cancelledAt": null,
      "cancellationReason": null,
      "createdAt": "2026-10-01T08:30:00.000Z",
      "updatedAt": "2026-10-01T08:30:00.000Z"
    }
  ],
  "correlationId": "c0ffee00-1111-4222-8333-444455556666"
}

Notes

A program target carries no program id. No live can be given that target today — only cohort is open to scheduling — and a MEMBER key never sees one.

GET /api/v1/live-sessions

Authorization

Role in the organization	This endpoint
`OWNER`	Allowed — every live of the school
`ADMIN`	Allowed — every live of the school
`MEMBER`	Conditional — only the lives that target one of the bearer's enrollments

Requirement	Rule for this endpoint
Business role	None — a coach sees the lives they are enrolled in, like anyone
Resource scope	The key's organization
Participation	For a `MEMBER`: an enrollment in the targeted cohort, in progress or completed
Resource state	None

Query parameters

Parameter	Type	Required	Description
`status`	string	no	`scheduled` or `cancelled`; all by default
`targetCohortId`	UUID	no	Only the lives targeting this cohort
`search`	string	no	Matches the title, up to 140 characters

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/live-sessions?status=scheduled" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the list, possibly empty.
400 Bad Request — an unknown status, or a cohort id that is not a UUID.
401 Unauthorized — missing, unknown or expired key.
403 Forbidden — the bearer is not a member of the school.

Response fields

Field	Type	Description
`data[].id`	UUID	Live session id
`data[].title` / `data[].description`	string	Title, and description or `null`
`data[].type`	string	`masterclass`, `workshop`, `qa`, `group_coaching` or `other`
`data[].status`	string	`scheduled` or `cancelled`
`data[].startsAt` / `data[].endsAt`	string	ISO 8601 instants
`data[].timezone`	string	IANA time zone the live was planned in
`data[].accessUrl`	string	Meeting link
`data[].provider`	string	`zoom`, `google_meet` or `other`
`data[].replayUrl`	string	Replay link, or `null`
`data[].hostUserId`	UUID	Host account, or `null`
`data[].targetType`	string	`cohort` — the only target open to scheduling
`data[].targetCohortId`	UUID	Targeted cohort, or `null`
`data[].targetCohortName`	string	Its name, or `null`
`data[].cancelledAt` / `data[].cancellationReason`	string	Set once cancelled
`data[].createdAt` / `data[].updatedAt`	string	ISO 8601

Example response

json

{
  "success": true,
  "data": [
    {
      "id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
      "title": "Weekly Q&A",
      "description": "Bring your questions",
      "type": "qa",
      "status": "scheduled",
      "startsAt": "2026-10-08T17:00:00.000Z",
      "endsAt": "2026-10-08T18:00:00.000Z",
      "timezone": "Europe/Paris",
      "accessUrl": "https://meet.google.com/abc-defg-hij",
      "provider": "google_meet",
      "replayUrl": null,
      "hostUserId": null,
      "targetType": "cohort",
      "targetCohortId": "3a1f7c2e-5b6d-4e8f-9a0b-1c2d3e4f5a6b",
      "targetCohortName": "Autumn cohort",
      "cancelledAt": null,
      "cancellationReason": null,
      "createdAt": "2026-10-01T08:30:00.000Z",
      "updatedAt": "2026-10-01T08:30:00.000Z"
    }
  ],
  "correlationId": "c0ffee00-1111-4222-8333-444455556666"
}

Notes

A program target carries no program id. No live can be given that target today — only cohort is open to scheduling — and a MEMBER key never sees one.

List live sessions

List live sessions

Authorization

Query parameters

Example

Response

Response fields

Example response

Notes

Related

Authorization

Query parameters

Example

Response

Response fields

Example response

Notes

Related