Kurse

Update course

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

PATCH / v1 / courses / {course_id}

Changes the fields that you send. All other fields stay. The fields have the same names and formats as in GET /v1/courses/{course_id}.

Renaming a course does not change the products that sell it.

Ändert sofort MCP-Werkzeug update_course

curl -X PATCH "https://api.tentary.com/v1/courses/202" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tracks_progress": true
}'

const response = await fetch("https://api.tentary.com/v1/courses/202", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "tracks_progress": true
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/courses/202",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "tracks_progress": True,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/courses/202');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'tracks_progress' => true,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "id": 202,
  "name": "Yoga for Runners",
  "description_html": "<p>Stretch and recover after every run.</p>",
  "cover_image_url": null,
  "layout": "cards",
  "tracks_progress": true,
  "lessons": 0,
  "participants": 0,
  "drip_release_hour": {
    "hour": 7,
    "time_zone": "Europe/Berlin"
  },
  "products": [],
  "items": [],
  "admin_url": "https://app.tentary.com/courses/edit/202"
}

Autorisierung

Authorization string Header erforderlich

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

Pfad-Parameter

course_id integer erforderlich

The id from list_courses.

min. 1 Beispiel: 202

Body application/json

name string

Course name.

min. Länge 1 max. Länge 255
description_html string

Introduction as HTML. Shows only with layout cards, above the modules.

max. Länge 65535
cover_image_url string kann null sein

Course banner: the image_url from finish_image, or a public image URL that Tentary copies.

max. Länge 2048
layout string

How buyers see the course. classic (default): sidebar and content. fullscreen: edge to edge. fokus: reading without distraction. cards: a start screen with module cards.

Mögliche Werte: classicfullscreenfokuscards
tracks_progress boolean

Buyers can mark lessons as done (default true). Needed for release type after_lesson.

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

id integer

The ID.
name string

The name.
description_html string

Shows only with layout cards.
cover_image_url string kann null sein

Course banner.
layout string

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

Mögliche Werte: 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).
2 Felder anzeigen Felder ausblenden
- hour integer
  
  0 to 23.
- time_zone string kann null sein
  
  The seller's time zone, like Europe/Berlin.
products array of object

Products that sell the course.
3 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string
  
  The name.
- status string
  
  The status.
  
  Mögliche Werte: livedraftarchived
items array of object

Modules and lessons in order.
9 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- kind string
  
  module or lesson.
  
  Mögliche Werte: modulelesson
- title string
  
  The title.
- cover_image_url string kann fehlen kann null sein
  
  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 kann null sein
  
  When buyers get the item. null = at once.
  Eine dieser Varianten:
  
  type: days_after_purchase · 2 Felder
  
  type string
  
  The rule type.
  
  Mögliche Werte: days_after_purchase
  
  days integer
  
  Days after the purchase.
  
  type: hours_after_purchase · 2 Felder
  
  type string
  
  The rule type.
  
  Mögliche Werte: hours_after_purchase
  
  hours integer
  
  Hours after the purchase.
  
  type: date · 2 Felder
  
  type string
  
  The rule type.
  
  Mögliche Werte: date
  
  date string<date>
  
  Like 2026-01-31.
  
  type: after_lesson · 4 Felder
  
  type string
  
  The rule type.
  
  Mögliche Werte: after_lesson
  
  lesson_id integer
  
  The lesson that the buyer must finish first.
  
  lesson_title string kann null sein
  
  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.
  
  9 Felder anzeigen Felder ausblenden
admin_url string<uri>

The page in the Tentary app.