Create Course

{
  "category": "course",
  "tier": "default",
  "unit": "lesson",
  "unitPrice": 0.05,
  "units": 10,
  "amountUsd": 0.50,
  "currency": "USD",
  "source": "platform_pricing_catalog_v2"
}

curl -X POST https://api.tutorflow.io/v1/platform/courses \
  -H "Authorization: Bearer tf_platform_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a beginner Python course covering variables, loops, and functions with hands-on exercises",
    "language": "en",
    "level": "beginner",
    "lessonCount": 5
  }'

{
  "id": "a1c2d3e4-f5g6-7h8i-9j0k-l1m2n3o4p5q6",
  "status": "COMPLETED",
  "courseId": "c7d8e9f0-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
  "title": "Python Quick Start",
  "description": "A beginner-friendly Python course covering variables, loops, and functions.",
  "language": "en",
  "subject": null,
  "level": "beginner",
  "slug": "python-quick-start-2e5ad6",
  "tier": "default",
  "mode": "sync",
  "hasQuiz": true,
  "hasPractice": true,
  "lessonCount": 6,
  "priceSnapshot": {
    "category": "course",
    "catalogKey": "course.default",
    "tier": "default",
    "unit": "lesson",
    "unitPrice": 0.05,
    "units": 6,
    "amountUsd": 0.30,
    "currency": "USD",
    "source": "platform_pricing_catalog_v2"
  },
  "shareToken": "b018172542f9a3c4d5e6f7890abcdef12345678",
  "thumbnailUrl": null,
  "previewUrl": "https://tutorflow.io/en/platform/courses/edit/9f3a...",
  "publicUrl": "https://tutorflow.io/en/platform/courses/b018172542f9.../lessons/1",
  "chapters": [
    { "title": "Introduction to Variables", "sequence": 1, "lessonCount": 2, "slug": "introduction-to-variables-cf1710" },
    { "title": "Working with Loops", "sequence": 2, "lessonCount": 2, "slug": "working-with-loops-253716" },
    { "title": "Defining Functions", "sequence": 3, "lessonCount": 2, "slug": "defining-functions-ad2b35" }
  ],
  "lessons": [
    { "title": "Welcome to Python", "type": "ai-tutor", "sequence": 1, "chapterTitle": "Introduction to Variables", "chapterSlug": "introduction-to-variables-cf1710", "lessonSlug": "welcome-to-python-29ae64", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/1" },
    { "title": "Variable Practice", "type": "coding-test", "sequence": 2, "chapterTitle": "Introduction to Variables", "chapterSlug": "introduction-to-variables-cf1710", "lessonSlug": "variable-practice-1b3f82", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/2" },
    { "title": "For and While Loops", "type": "coding-lesson", "sequence": 3, "chapterTitle": "Working with Loops", "chapterSlug": "working-with-loops-253716", "lessonSlug": "for-and-while-loops-59c305", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/3" },
    { "title": "Loop Challenges", "type": "coding-test", "sequence": 4, "chapterTitle": "Working with Loops", "chapterSlug": "working-with-loops-253716", "lessonSlug": "loop-challenges-a4b5c6", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/4" },
    { "title": "Writing Functions", "type": "coding-lesson", "sequence": 5, "chapterTitle": "Defining Functions", "chapterSlug": "defining-functions-ad2b35", "lessonSlug": "writing-functions-d7e8f9", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/5" },
    { "title": "Function Exercises", "type": "coding-test", "sequence": 6, "chapterTitle": "Defining Functions", "chapterSlug": "defining-functions-ad2b35", "lessonSlug": "function-exercises-0a1b2c", "lessonUrl": "https://tutorflow.io/en/platform/courses/b018.../lessons/6" }
  ],
  "idempotencyKey": null,
  "idempotentReplay": null,
  "isTerminal": true,
  "createdAt": "2026-03-24T10:32:15.108Z",
  "completedAt": "2026-03-24T10:32:37.671Z"
}

curl -X POST https://api.tutorflow.io/v1/platform/courses/a1c2d3e4-5678-4abc-9def-0123456789ab/edit-token \
  -H "Authorization: Bearer tf_platform_..."

{
  "editToken": "new-token-hex...",
  "editTokenExpiresAt": "2026-03-24T13:30:00.000Z"
}

curl https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/canonical

curl -X PATCH https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/canonical \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Python Foundations",
    "description": "A practical Python course.",
    "slug": "python-foundations",
    "chapters": [
      { "id": "getting-started", "title": "Getting Started", "slug": "getting-started", "sequence": 1 }
    ],
    "lessons": [
      {
        "id": "2ca91d88-7b0c-4287-89f1-89a74d8a5b26",
        "chapterId": "getting-started",
        "title": "Variables and Types",
        "description": "Learn how Python stores data.",
        "slug": "variables-and-types",
        "type": "ai-tutor",
        "sequence": 1,
        "lecture": "<p>Python variables are names for values...</p>",
        "content": { "blocks": [] },
        "quizzes": [],
        "problems": [],
        "metadata": { "duration": 12 }
      }
    ]
  }'

curl https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/lessons/by-id/{lessonId}/full

curl -X PATCH https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/lessons/by-id/{lessonId}/full \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Control Flow",
    "type": "ai-tutor",
    "chapterId": "python-basics",
    "sequence": 2,
    "lecture": "<p>Use if statements to branch...</p>",
    "content": { "blocks": [] },
    "quizzes": [],
    "problems": [],
    "metadata": { "duration": 15 }
  }'

curl -N -X POST https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/lessons/by-id/{lessonId}/generate \
  -H "Content-Type: application/json" \
  -d '{
    "chapter": { "id": "python-basics", "name": "Python Basics" },
    "courseTitle": "Python Foundations",
    "courseDescription": "A practical Python course.",
    "shouldGenerateImage": false
  }'

curl -X POST https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/lessons \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Solving Quadratic Equations",
    "description": "Practice the quadratic formula on real problems.",
    "type": "ai-tutor",
    "quizCount": 0,
    "chapterSequence": 2
  }'

curl -X PATCH https://api.tutorflow.io/v1/platform/courses/edit/{editToken} \
  -H "Content-Type: application/json" \
  -d '{ "title": "New Title", "description": "Updated overview." }'

curl -X PATCH https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/lessons/3 \
  -H "Content-Type: application/json" \
  -d '{ "lecture": "<p>Updated HTML</p>", "title": "Loops, Revisited" }'

curl -X POST https://api.tutorflow.io/v1/platform/courses/edit/{editToken}/infer-type \
  -H "Content-Type: application/json" \
  -d '{
    "lessonTitle": "Practice: Factoring Polynomials",
    "lessonDescription": "Hands-on practice problems for factoring.",
    "courseTitle": "Intermediate Algebra",
    "courseDescription": "Algebra fundamentals for high school students.",
    "existingLessons": [
      { "title": "Welcome to Algebra", "type": "ai-tutor" },
      { "title": "Variables and Expressions", "type": "ai-tutor" }
    ]
  }'

{ "type": "exam" }