Courses · Tentary API Reference

Courses

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

The online courses of the account: name, number of lessons (drafts included) and the products that give access.

Archived courses are left out.
legacy_courses are old courses that nobody has opened in the new course editor yet.

For the modules, lessons and number of participants of one course, call GET /v1/courses/{course_id}.

Reads only MCP tool list_courses

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

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

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

200 · Response

{
  "courses": [
    {
      "id": 201,
      "name": "Morning Yoga in 30 Days",
      "lessons": 3,
      "products": [
        {
          "id": 102,
          "name": "Morning Yoga in 30 Days",
          "status": "live"
        },
        {
          "id": 104,
          "name": "Retreat Bundle",
          "status": "draft"
        }
      ],
      "admin_url": "https://app.tentary.com/courses/edit/201"
    }
  ],
  "legacy_courses": [],
  "truncated": false,
  "links": {
    "courses": "https://app.tentary.com/courses"
  }
}

Authorization

Authorization string header required

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

Response

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

courses array of object

The courses, newest first.
Show 5 fields Hide fields
- id integer
  
  The ID.
- name string
  
  The name.
- lessons integer
  
  Lessons, drafts included.
- products array of object
  
  Products that give access.
  Show 3 fields Hide fields
  
  id integer
  
  The ID.
  
  name string
  
  Product name.
  
  status string
  
  archived = deleted.
  
  Allowed values: livedraftarchived
- admin_url string<uri>
  
  The page in the Tentary app.
legacy_courses array of object

Old courses that the seller has not opened in the new course editor yet.
Show 3 fields Hide fields
- product_id integer
  
  The product ID.
- name string
  
  The name.
- admin_url string<uri>
  
  The page in the Tentary app.
truncated boolean

true = the account has more than 200 courses.
links object

Pages in the Tentary app or on tentary.com.
Show 1 field Hide fields
- courses string<uri>
  
  Page in the Tentary app.