Lessons

A lesson is an authored training unit. Lessons are distinct from raw source content: a lesson teaches a sequence of content pieces. To read the source files themselves, use content.

List lessons

GET /v1/lessons

Lists lessons in the catalog, most recent first, scoped to your lesson visibility (team, public, or managed).

Query parameters

Parameter	Type	Notes
`query`	string	Title keywords. Every word must appear in the lesson title.
`cursor`	string	Pagination cursor from a previous response.
`limit`	number	1–100. Default 50.

Request

curl "https://api.mereon.ai/v1/lessons?query=onboarding" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "data": [
    {
      "id": "lsn_6e3f...",
      "title": "New hire onboarding",
      "description": "What every new employee needs in week one.",
      "format": "GUIDED",
      "difficulty": "beginner",
      "url": "https://mereon.ai/lessons/new-hire-onboarding",
      "createdAt": "2026-02-01T10:00:00.000Z",
      "updatedAt": "2026-05-20T10:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Field	Type	Notes
`format`	string	`GUIDED` (AI-taught) or `CURATED` (author’s content in order).
`difficulty`	string	Difficulty level of the lesson.

Get a lesson

GET /v1/lessons/{id}

Lesson detail, including the source content pieces it teaches, in order. Returns 404 if the lesson is not visible to you.

Response

{
  "id": "lsn_6e3f...",
  "title": "New hire onboarding",
  "description": "What every new employee needs in week one.",
  "format": "GUIDED",
  "difficulty": "beginner",
  "url": "https://mereon.ai/lessons/new-hire-onboarding",
  "createdAt": "2026-02-01T10:00:00.000Z",
  "updatedAt": "2026-05-20T10:00:00.000Z",
  "contents": [
    { "id": "cnt_44de...", "title": "Finance Handbook", "type": "document" },
    { "id": "cnt_91ab...", "title": "Office tour", "type": "video" }
  ]
}