Courses

Course outline

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 / courses / {course_id}

The settings of a course and its modules and lessons in order. Each item has its draft and free preview flags and its release rule: days or hours after the purchase, a date, or after another lesson.

Release days and dates unlock at drip_release_hour in its time_zone. That is the time zone of the account, not UTC.
The number of participants counts buyers and people with granted access, each email address once.
The answer also lists the products that sell the course.

For the content of a lesson, call GET /v1/lessons/{lesson_id}. The fields have the same names and formats as in PATCH /v1/courses/{course_id}, PATCH /v1/modules/{module_id} and PATCH /v1/lessons/{lesson_id}.

Reads only MCP tool get_course_outline

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

const response = await fetch("https://api.tentary.com/v1/courses/201", {
  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/courses/201",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/courses/201');
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": 201,
  "name": "Morning Yoga in 30 Days",
  "description_html": "<p>Ten minutes every morning.</p>",
  "cover_image_url": "https://img.tentary.com/demo-course-banner.jpg",
  "layout": "classic",
  "tracks_progress": true,
  "lessons": 3,
  "participants": 1,
  "drip_release_hour": {
    "hour": 7,
    "time_zone": "Europe/Berlin"
  },
  "products": [
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days",
      "status": "live"
    },
    {
      "id": 104,
      "name": "Retreat Bundle",
      "status": "draft"
    }
  ],
  "items": [
    {
      "id": 301,
      "kind": "module",
      "title": "Week 1: Arrive",
      "cover_image_url": null,
      "position": 1,
      "draft": false,
      "free_preview": false,
      "release": null,
      "items": [
        {
          "id": 302,
          "kind": "lesson",
          "title": "Welcome and setup",
          "position": 1,
          "draft": false,
          "free_preview": true,
          "release": null,
          "items": []
        },
        {
          "id": 303,
          "kind": "lesson",
          "title": "Sun salutation",
          "position": 2,
          "draft": false,
          "free_preview": false,
          "release": {
            "type": "days_after_purchase",
            "days": 1
          },
          "items": []
        }
      ]
    },
    {
      "id": 304,
      "kind": "module",
      "title": "Week 2: Balance",
      "cover_image_url": null,
      "position": 2,
      "draft": false,
      "free_preview": false,
      "release": null,
      "items": [
        {
          "id": 306,
          "kind": "module",
          "title": "Standing poses",
          "cover_image_url": null,
          "position": 1,
          "draft": false,
          "free_preview": false,
          "release": null,
          "items": [
            {
              "id": 307,
              "kind": "module",
              "title": "Day 8",
              "cover_image_url": null,
              "position": 1,
              "draft": false,
              "free_preview": false,
              "release": null,
              "items": [
                {
                  "id": 305,
                  "kind": "lesson",
                  "title": "Tree pose",
                  "position": 1,
                  "draft": false,
                  "free_preview": false,
                  "release": {
                    "type": "after_lesson",
                    "lesson_id": 303,
                    "lesson_title": "Sun salutation",
                    "enforced": true
                  },
                  "items": []
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "admin_url": "https://app.tentary.com/courses/edit/201"
}

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

course_id integer required

The id from list_courses.

min 1 Example: 201

Response

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

id integer

The ID.
name string

The name.
description_html string

Shows only with layout cards.
cover_image_url string can be null

Course banner.
layout string

How buyers see the course: classic, fullscreen, fokus or cards.

Allowed values: classicfullscreenfokuscards
tracks_progress boolean

true = buyers can mark lessons as done.
lessons integer

Lessons, drafts included.
participants integer

Buyers and people with granted access, each e-mail address once.
drip_release_hour object

Lessons with release days or a date unlock at this hour, in this time zone (not UTC).
Show 2 fields Hide fields
- hour integer
  
  0 to 23.
- time_zone string can be null
  
  The seller's time zone, like Europe/Berlin.
products array of object

Products that sell the course.
Show 3 fields Hide fields
- id integer
  
  The ID.
- name string
  
  The name.
- status string
  
  The status.
  
  Allowed values: livedraftarchived
items array of object

Modules and lessons in order.
Show 9 fields Hide fields
- id integer
  
  The ID.
- kind string
  
  module or lesson.
  
  Allowed values: modulelesson
- title string
  
  The title.
- cover_image_url string can be left out can be null
  
  Modules only.
- position integer
  
  Place in its module or among the main items, 1 = first.
- draft boolean
  
  A draft module hides all items in it.
- free_preview boolean
  
  true = everyone can open it as a free preview, also without a purchase.
- 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.
- items array of object
  
  The items of a module, in order (modules and lessons). Empty for a lesson.
  
  Show 9 fields Hide fields
admin_url string<uri>

The page in the Tentary app.