Get live session

Authorization

Organization role

Role in the organization	This endpoint
OWNER	Allowed
ADMIN	Allowed
MEMBER	Conditional

Business authorization

Members read only lives in the audience of their enrollments. An organization owner or administrator may read all lives in that school.

Requirement	Rule
Business role	None beyond the organization role
Resource scope	Current school and the permitted resource scope
Participation	Audience enrollment for member readers
Resource state	No additional state restriction

Parameter

Type

Required

Description

liveSessionId

UUID

yes

Resource in the permitted school and scope.

Field

Type

Nullable

Description

success

boolean

True on success.

data

object

Requested domain data within your permitted scope.

data.id

UUID

Public identifier, when this endpoint returns a single resource.

Example response

json

{
  "success": true,
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "title": "Weekly live",
    "status": "scheduled",
    "startsAt": "2030-01-10T09:00:00.000Z",
    "endsAt": "2030-01-10T10:00:00.000Z",
    "timezone": "Europe/Paris",
    "targetType": "cohort",
    "targetCohortId": "00000000-0000-4000-8000-000000000001"
  }
}

GET /api/v1/live-sessions/{liveSessionId}

Get live session using the current permissions of the key holder. The school comes from the verified key. MCP equivalent: get_live_session.

Authorization

Organization role

Role in the organization	This endpoint
OWNER	Allowed
ADMIN	Allowed
MEMBER	Conditional

Business authorization

Members read only lives in the audience of their enrollments. An organization owner or administrator may read all lives in that school.

Requirement	Rule
Business role	None beyond the organization role
Resource scope	Current school and the permitted resource scope
Participation	Audience enrollment for member readers
Resource state	No additional state restriction

Path parameters

Parameter	Type	Required	Description
`liveSessionId`	UUID	yes	Resource in the permitted school and scope.

Example

bash

curl -X GET "$COHORTE_API_BASE_URL/api/v1/live-sessions/00000000-0000-4000-8000-000000000001" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 — successful read, mutation or retry.
400 — invalid request.
401 — invalid key, bearer or school membership.
403 — insufficient permission.
404 — absent or outside the permitted scope.
500 — unexpected failure; retry only the identical intention.

Response fields

Field	Type	Nullable	Description
`success`	boolean	no	True on success.
`data`	object	no	Requested domain data within your permitted scope.
`data.id`	UUID	no	Public identifier, when this endpoint returns a single resource.

Example response

json

{
  "success": true,
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "title": "Weekly live",
    "status": "scheduled",
    "startsAt": "2030-01-10T09:00:00.000Z",
    "endsAt": "2030-01-10T10:00:00.000Z",
    "timezone": "Europe/Paris",
    "targetType": "cohort",
    "targetCohortId": "00000000-0000-4000-8000-000000000001"
  }
}

Get live session

Get live session

Authorization

Organization role

Business authorization

Path parameters

Example

Response

Response fields

Example response

Notes

Authorization

Organization role

Business authorization

Path parameters

Example

Response

Response fields

Example response

Notes

Get live session

Get live session

Authorization

Organization role

Business authorization

Path parameters

Example

Response

Response fields

Example response

Notes

Related

Authorization

Organization role

Business authorization

Path parameters

Example

Response

Response fields

Example response

Notes

Related