Skip to content
MereonMereonMereon Docs

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

Section titled “List lessons”

GET /v1/lessons

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

Query parameters

Section titled “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

Section titled “Request”
Terminal window
curl "https://api.mereon.ai/v1/lessons?query=onboarding" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

Section titled “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

Section titled “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

Section titled “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" }
  ]
}