List coaching sessions

GET /api/v1/enrollments/{enrollmentId}/coaching-sessions

Returns the coaching sessions of one enrollment, from the most recent to the oldest, with their entries. Entries marked coach_only are returned only to a caller who may also document the enrollment.

Authorization

Organization role

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Conditional — only with a business role below

Business authorization

Requirement	Rule for this endpoint
Business role	`coach` scoped to this enrollment, or `program_director` scoped to the organization
Resource scope	Enrollment of the organization attached to the API key
Participation	The coach must be assigned to this enrollment
Resource state	None

Path parameters

Parameter	Type	Required	Description
`enrollmentId`	UUID	yes	Enrollment visible from the key's organization

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/enrollments/ENROLLMENT_ID/coaching-sessions" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the sessions the caller may read, possibly an empty list.
401 Unauthorized — the key is missing, invalid, or no longer attached to a member.
403 Forbidden — the bearer cannot read this enrollment's coaching.
404 Not Found — the enrollment is unknown or belongs to another organization.

Response fields

Field	Type	Nullable	Description
`success`	boolean	no	`true` for a successful request
`data[]`	array	no	Sessions, most recent first; same shape as a recorded session
`canWrite`	boolean	no	`true` when the caller may also record sessions on this enrollment

An empty list means no session has been recorded, or that none of them carries an entry this caller may read.

Example response

json

{
  "success": true,
  "canWrite": true,
  "data": [
    {
      "id": "9f2c0a1e-0000-4000-8000-000000000000",
      "enrollmentId": "4af4cd8d-0000-4000-8000-000000000000",
      "heldAt": "2026-09-01T14:30:00.000Z",
      "recordedBy": "1b7d2f30-0000-4000-8000-000000000000",
      "recordedByName": "Karim Haddad",
      "recordedAt": "2026-09-01T14:32:00.000Z",
      "entries": [
        {
          "id": "3ac91b70-0000-4000-8000-000000000000",
          "kind": "decision",
          "visibility": "shared_with_member",
          "body": "Focus on industrial SMEs until the end of the month.",
          "ownerType": null,
          "ownerUserId": null,
          "dueAt": null,
          "promotedNextActionId": null,
          "supersedesEntryId": null,
          "addedAt": "2026-09-01T14:32:00.000Z"
        }
      ]
    }
  ]
}

Notes

The list is read-only and emits no event.
An entry that has been corrected stays in the list; the correction is a new entry whose supersedesEntryId names it.

GET /api/v1/enrollments/{enrollmentId}/coaching-sessions

Authorization

Organization role

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Conditional — only with a business role below

Business authorization

Requirement	Rule for this endpoint
Business role	`coach` scoped to this enrollment, or `program_director` scoped to the organization
Resource scope	Enrollment of the organization attached to the API key
Participation	The coach must be assigned to this enrollment
Resource state	None

Path parameters

Parameter	Type	Required	Description
`enrollmentId`	UUID	yes	Enrollment visible from the key's organization

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/enrollments/ENROLLMENT_ID/coaching-sessions" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the sessions the caller may read, possibly an empty list.
401 Unauthorized — the key is missing, invalid, or no longer attached to a member.
403 Forbidden — the bearer cannot read this enrollment's coaching.
404 Not Found — the enrollment is unknown or belongs to another organization.

Response fields

Field	Type	Nullable	Description
`success`	boolean	no	`true` for a successful request
`data[]`	array	no	Sessions, most recent first; same shape as a recorded session
`canWrite`	boolean	no	`true` when the caller may also record sessions on this enrollment

An empty list means no session has been recorded, or that none of them carries an entry this caller may read.

Example response

json

{
  "success": true,
  "canWrite": true,
  "data": [
    {
      "id": "9f2c0a1e-0000-4000-8000-000000000000",
      "enrollmentId": "4af4cd8d-0000-4000-8000-000000000000",
      "heldAt": "2026-09-01T14:30:00.000Z",
      "recordedBy": "1b7d2f30-0000-4000-8000-000000000000",
      "recordedByName": "Karim Haddad",
      "recordedAt": "2026-09-01T14:32:00.000Z",
      "entries": [
        {
          "id": "3ac91b70-0000-4000-8000-000000000000",
          "kind": "decision",
          "visibility": "shared_with_member",
          "body": "Focus on industrial SMEs until the end of the month.",
          "ownerType": null,
          "ownerUserId": null,
          "dueAt": null,
          "promotedNextActionId": null,
          "supersedesEntryId": null,
          "addedAt": "2026-09-01T14:32:00.000Z"
        }
      ]
    }
  ]
}

Notes

The list is read-only and emits no event.
An entry that has been corrected stays in the list; the correction is a new entry whose supersedesEntryId names it.

List coaching sessions

List coaching sessions

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