Courses

Lesson

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

GET / v1 / lessons / {lesson_id}

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}.

Reads only MCP tool get_lesson

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

const response = await fetch("https://api.tentary.com/v1/lessons/302", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/lessons/302",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/lessons/302');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "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"
}

Authorization

Authorization string header required

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

Path parameters

lesson_id integer required

The id from get_course_outline.

min 1 Example: 302

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

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 these variants:
type: days_after_purchase · 2 fields
- type string
  
  The rule type.
  
  Allowed values: days_after_purchase
- days integer
  
  Days after the purchase.
type: hours_after_purchase · 2 fields
- type string
  
  The rule type.
  
  Allowed values: hours_after_purchase
- hours integer
  
  Hours after the purchase.
type: date · 2 fields
- type string
  
  The rule type.
  
  Allowed values: date
- date string<date>
  
  Like 2026-01-31.
type: after_lesson · 4 fields
- 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 these variants:
type: text · 2 fields
Formatted text.
- type string
  
  The block type.
  
  Allowed values: text
- html string
  
  The text as HTML.
type: image, video · 5 fields
An uploaded image or video.
- type string
  
  The block type.
  
  Allowed values: imagevideo
- 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.
type: audio, file · 6 fields
An audio player or a download.
- type string
  
  The block type.
  
  Allowed values: audiofile
- 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.
type: video_embed · 2 fields
- type string
  
  The block type.
  
  Allowed values: video_embed
- url string
  
  YouTube, Vimeo or Loom link.
type: button · 3 fields
A link 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.