Form Teachers
Manage form teacher assignments to cohort batches.
All endpoints require
Authorization: Bearer <token>.
Get Form Teachers
GET /teachers/{cohortId}
Get the form teacher assigned to a specific cohort.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
cohortId | uuid | Cohort ID |
Example
curl -X GET https://api.vanillatots.com/teachers/{cohortId} \
-H "Authorization: Bearer $TOKEN"
Response 200 OK
{
"batch_id": "uuid",
"first_name": "Ada",
"last_name": "Okafor",
"image_url": "https://..."
}
Assign Form Teacher
PATCH /teachers/{id}/add_to_batch
Assign a teacher to a cohort batch as form teacher.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | uuid | Cohort batch ID |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
teacher_id | uuid | Yes | Employee ID of the teacher |
Example
curl -X PATCH https://api.vanillatots.com/teachers/{id}/add_to_batch \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "teacher_id": "employee-uuid" }'
Response 200 OK — Returns a FormTeacherResponse.
Unassign Form Teacher
DELETE /teachers/{id}/teachers/{teacherId}
Remove a form teacher assignment from a cohort.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | uuid | Cohort batch ID |
teacherId | uuid | Teacher (employee) ID |
Response 200 OK