# Lesson

`GET https://api.tentary.com/v1/lessons/{lesson_id}`

Source: https://tentary.com/en/help/api/get-lesson/
Area: Courses
MCP tool: `get_lesson`. Reads only. Changes nothing in the account.

---

One lesson of a course: its content blocks, its draft and free preview flags and its release rule.

Content blocks can be texts, images, videos, audio, files (with `file_id` and name, but no download links), video links and buttons. The fields have the same names and formats as in [`PATCH /v1/lessons/{lesson_id}`](https://tentary.com/en/help/api/update-lesson/).

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Path parameters

- `lesson_id` (integer, required, path): The id from get_course_outline. Limits: min 1.

## Response

- `id` (integer): The ID.
- `course_id` (integer): The course of the lesson.
- `course_name` (string): The course name.
- `module_id` (integer, can be null): The module of the lesson.
- `title` (string): The title.
- `position` (integer): Place in its module, 1 = first.
- `draft` (boolean): true = buyers do not see it.
- `free_preview` (boolean): true = everyone can watch it as a free preview.
- `release` (object, can be null): When buyers get the item. null = at once.
  - One of:
    - Variant type: days_after_purchase:
      - `type` (string): The rule type. Allowed values: `days_after_purchase`.
      - `days` (integer): Days after the purchase.
    - Variant type: hours_after_purchase:
      - `type` (string): The rule type. Allowed values: `hours_after_purchase`.
      - `hours` (integer): Hours after the purchase.
    - Variant type: date:
      - `type` (string): The rule type. Allowed values: `date`.
      - `date` (string<date>): Like 2026-01-31.
    - Variant type: after_lesson:
      - `type` (string): The rule type. Allowed values: `after_lesson`.
      - `lesson_id` (integer): The lesson that the buyer must finish first.
      - `lesson_title` (string, can be null): The title of that lesson.
      - `enforced` (boolean): false = the course does not track progress, so the rule has no effect.
- `content` (array of object): Content blocks, in order.
  - One of:
    - Variant type: text:
      - `type` (string): The block type. Allowed values: `text`.
      - `html` (string): The text as HTML.
    - Variant type: image, video:
      - `type` (string): The block type. Allowed values: `image`, `video`.
      - `file_id` (integer): The file ID (from upload_file).
      - `name` (string): The name.
      - `file_type` (string): File extension, like pdf.
      - `size_bytes` (integer, can be null): File size in bytes.
    - Variant type: audio, file:
      - `type` (string): The block type. Allowed values: `audio`, `file`.
      - `file_id` (integer): The file ID (from upload_file).
      - `name` (string): The name.
      - `description` (string): file: text under the download. audio: title above the player.
      - `file_type` (string): File extension, like pdf.
      - `size_bytes` (integer, can be null): File size in bytes.
    - Variant type: video_embed:
      - `type` (string): The block type. Allowed values: `video_embed`.
      - `url` (string): YouTube, Vimeo or Loom link.
    - Variant type: button:
      - `type` (string): The block type. Allowed values: `button`.
      - `label` (string): The text that buyers see.
      - `url` (string): The link.
- `admin_url` (string<uri>): The page in the Tentary app.

## Example request

```bash
curl "https://api.tentary.com/v1/lessons/302" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "id": 302,
  "course_id": 201,
  "course_name": "Morning Yoga in 30 Days",
  "module_id": 301,
  "title": "Welcome and setup",
  "position": 1,
  "draft": false,
  "free_preview": true,
  "release": null,
  "content": [
    {
      "type": "text",
      "html": "<p>Roll out your mat and breathe in for four counts.</p>"
    },
    {
      "type": "video_embed",
      "url": "https://www.youtube.com/watch?v=demo1234567"
    }
  ],
  "admin_url": "https://app.tentary.com/courses/edit/201#l302"
}
```