Skip to main content

​
Current API

​
Get lesson

GET /api/lessons/{id}
Auth: web.api

​
Edit lesson (reschedule)

PUT /api/lessons/{id}/edit
Auth: web.api Proposes a reschedule with new suggested_start and suggested_finish times.
Requires 72+ hours advance notice before the original lesson start time.
Sends LessonReschedule email with Accept/Decline signed URL buttons.

​
Approve lesson

PUT /api/lessons/{id}/approve
Auth: web.api Accepts a reschedule proposal. Updates lesson times to suggested values, sets state back to ACTIVE. Sends LessonBooked confirmation email.

​
Cancel lesson

PUT /api/lessons/{id}/cancel
Auth: web.api Cancels the lesson. Triggers refund processing.

​
Legacy v1 API

​
Lessons CRUD

GET    /api/v1/lessons
POST   /api/v1/lessons
GET    /api/v1/lessons/{id}
PUT    /api/v1/lessons/{id}
DELETE /api/v1/lessons/{id}
Auth: auth:api

​
Notes

GET    /api/v1/notes
POST   /api/v1/notes
GET    /api/v1/notes/{id}
PUT    /api/v1/notes/{id}
DELETE /api/v1/notes/{id}
Auth: auth:api Lesson notes with file attachments. When a tutor adds a note:
  1. Note saved with text and summary
  2. Files attached via polymorphic fileables table
  3. Student receives LessonSummaryNote email
  4. Student receives push notification with booking details

​
Lesson states reference

StateValueTransitions to
ACTIVE1RESCHEDULE, CANCELLED
RESCHEDULE2ACTIVE (approved), CANCELLED (declined/expired)
CANCELLED0(terminal)

​
Experience rating

After a lesson, students can rate their experience (1-5): 
PUT /api/v1/lessons/{id}
Body: { "experience_rating": 4 }