Skip to main content

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

ParameterTypeDescription
cohortIduuidCohort 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

ParameterTypeDescription
iduuidCohort batch ID

Request Body

FieldTypeRequiredDescription
teacher_iduuidYesEmployee 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

ParameterTypeDescription
iduuidCohort batch ID
teacherIduuidTeacher (employee) ID

Response 200 OK