Create Course

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": "standard",
  "mode": "sync",
  "hasQuiz": true,
  "hasPractice": true,
  "lessonCount": 6,
  "priceSnapshot": {
    "category": "course",
    "catalogKey": "course.standard",
    "tier": "standard",
    "amountUsd": 0.19,
    "unit": "course",
    "currency": "USD",
    "source": "platform_pricing_catalog_v1"
  },
  "shareToken": "b018172542f9a3c4d5e6f7890abcdef12345678",
  "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.../edit-token \
  -H "Authorization: Bearer tf_platform_..."

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

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