Managed Lessons let your app deliver learning experiences powered by Timeback’s lesson engine. Instead of building your own content pipeline, sequencing logic, and scoring system, you callDocumentation Index
Fetch the complete documentation index at: https://docs.timeback.com/llms.txt
Use this file to discover all available pages before exploring further.
timeback.lessons.* and the SDK handles the rest.
When to use
| Custom Activities | Managed Lessons | |
|---|---|---|
| Content | Your own content and logic | Timeback’s course builder |
| Platform role | Time and completion reporting | Sequencing, scoring, and XP |
| Integration level | Level 1 | Level 2 |
How it works
Your app renders the UI. The SDK manages everything else: discovering available lessons, serving questions, accepting answers, scoring, and tracking time. Under the hood, the SDK orchestrates two Timeback systems:| System | Purpose | What it provides |
|---|---|---|
| OneRoster | Lesson discovery | Courses, components, and resources |
| PowerPath | Assessment runtime | Sequencing, questions, scoring |
TimeSpentEvent heartbeats.
The lesson lifecycle
A typical Managed Lesson flow has four phases:| Phase | SDK method | What happens |
|---|---|---|
| Discover | lessons.list() | List available lessons |
| Start | lessons.start() | Begin or resume an attempt |
| Next question | session.next() | Fetch the next question |
| Submit answer | session.submit() | Score and record a response |
| Complete | session.complete() | Finalize scoring, flush time |
LessonSession object returned by lessons.start() is the central runtime. It tracks state like score, attempt, and finalized, and updates these properties as the session progresses.
Caliper behavior
| Event | Sent by | Purpose |
|---|---|---|
TimeSpentEvent | SDK | Time tracking heartbeats (every 15s) |
ActivityEvent | PowerPath | Scoring, XP, and gradebook writes |
ActivityCompletedEvent for Managed Lessons. PowerPath is the source of truth for completion, XP, and gradebook updates.
Configuration
Managed Lessons require a Caliper sensor URL in yourtimeback.config.json.
See the configuration
reference for sensor
resolution rules and environment overrides.
Next steps
Lesson discovery
List available lessons and start a session
Question loop
Fetch questions and submit answers
Completion
Finalize scoring and interpret results
Attempt history
Review past attempts and per-question data
Reference
Parameters, properties, methods, and return types
Configuration
Full timeback.config.json reference
Getting started
Onboarding guide for building native apps on Timeback