Lesson Endpoints

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:

Note saved with text and summary
Files attached via polymorphic fileables table
Student receives LessonSummaryNote email
Student receives push notification with booking details

Lesson states reference

State	Value	Transitions to
ACTIVE	1	RESCHEDULE, CANCELLED
RESCHEDULE	2	ACTIVE (approved), CANCELLED (declined/expired)
CANCELLED	0	(terminal)

Experience rating

After a lesson, students can rate their experience (1-5):

PUT /api/v1/lessons/{id}
Body: { "experience_rating": 4 }

​Current API

​Get lesson

​Edit lesson (reschedule)

​Approve lesson

​Cancel lesson

​Legacy v1 API

​Lessons CRUD

​Notes

​Lesson states reference

​Experience rating

Current API

Get lesson

Edit lesson (reschedule)

Approve lesson

Cancel lesson

Legacy v1 API

Lessons CRUD

Notes

Lesson states reference

Experience rating