GET /api/v1/me/lessons/{lessonId}/note
Returns your private note on a lesson: its Markdown body and the files you
attached, described by name, type and size. The lesson must be one you can read
in Cohorte through one of your enrollments; otherwise, and when you have no note
there, the answer is 404.
| Role in the organization | This endpoint |
|---|
OWNER | Allowed — reads the key holder's own note only |
ADMIN | Allowed — reads the key holder's own note only |
MEMBER | Allowed — reads the key holder's own note only |
| Requirement | Rule for this endpoint |
|---|
| Business role | None |
| Resource scope | A lesson of the program of one of your enrollments |
| Participation | At least one of your enrollments makes the lesson readable (not suspended, cohort open, step unlocked) |
| Resource state | Published lesson in a visible course |
School staff read learners' notes in the member record inside Cohorte, never
through this endpoint: it only ever returns the note of the key holder.
| Parameter | Type | Required | Description |
|---|
lessonId | UUID | yes | A lesson you can read |
curl "$COHORTE_API_BASE_URL/api/v1/me/lessons/$LESSON_ID/note" \
-H "x-api-key: $COHORTE_API_KEY"
200 OK — your note.400 Bad Request — lessonId is not a UUID.401 Unauthorized — missing, unknown or expired key.404 Not Found — no note on this lesson, a lesson you cannot read (locked, draft, another program, suspended enrollment), or another school's.
| Field | Type | Nullable | Description |
|---|
data.lessonId | UUID | no | The lesson |
data.body | string | no | Markdown, up to 10,000 characters |
data.attachments[] | array | no | {id, name, mimeType, sizeBytes} — metadata only, no file content and no URL |
data.createdAt | string | no | ISO 8601 |
data.updatedAt | string | no | ISO 8601 |
{
"success": true,
"data": {
"lessonId": "0f1e2d3c-4b5a-4968-8778-695a4b3c2d1e",
"body": "## To remember\n\nAsk three questions before the price.",
"attachments": [
{"id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "name": "objection-grid.pdf", "mimeType": "application/pdf", "sizeBytes": 48213}
],
"createdAt": "2026-10-07T09:12:00.000Z",
"updatedAt": "2026-10-07T10:40:00.000Z"
},
"correlationId": "c0ffee00-1111-4222-8333-444455556666"
}
- Attached files are uploaded and downloaded in Cohorte only. The API never
returns their content or a link to them.
