Sign in
Students

Update student

Changed on

Update an existing student's information (partial update)

patch/students/{id}

Request

  • Base URL: http://localhost:8080/api/v1
  • URL: http://localhost:8080/api/v1/students/{id}
  • Auth: none declared

Path parameters

idstring uuid required

Student ID

Request body

first_namestring

Student's first name

last_namestring

Student's last name

dobstring date nullable

Student's date of birth (YYYY-MM-DD format, can be set to null)

therapist_idstring uuid

ID of the assigned therapist

school_idinteger

ID of the school the student attends

gradeinteger nullable

Student's current grade level (can be set to null). -1 = graduated, 0 = kindergarten, 1-12 = grades 1-12

iepstring[] nullable

Updated list of IEP goals (can be set to null or empty array)

Example request

{
  "first_name": "John",
  "last_name": "Doe",
  "dob": "2010-05-15",
  "therapist_id": "987fcdeb-51a2-43d1-9f4c-123456789abc",
  "school_id": 1,
  "grade": 6,
  "iep": [
    "Updated IEP with advanced speech therapy goals",
    "Reading comprehension support"
  ]
}

Response

Student updated successfully

idstring uuid required

Unique identifier for the student

first_namestring required

Student's first name

last_namestring required

Student's last name

dobstring date-time

Student's date of birth

therapist_idstring uuid required

UUID of the assigned therapist

school_idinteger required

ID of the school the student attends

school_namestring nullable

Name of the school the student attends

district_idinteger nullable

ID of the school district the student belongs to

gradeinteger nullable

Student's current grade level. -1 = graduated, 0 = kindergarten, 1-12 = grades 1-12

iepstring[] nullable

List of Individualized Education Program goals

created_atstring date-time required

Timestamp when the student record was created

updated_atstring date-time required

Timestamp when the student record was last updated

Example response

{
  "id": "843d4807-1397-4227-9328-330adea56993",
  "first_name": "John",
  "last_name": "Doe",
  "dob": "2010-05-15T00:00:00Z",
  "therapist_id": "9dad94d8-6534-4510-90d7-e4e97c175a65",
  "school_id": 3,
  "school_name": "Generate High",
  "district_id": 2,
  "grade": 5,
  "iep": [
    "Active IEP with speech therapy goals",
    "Occupational therapy accommodations"
  ],
  "created_at": "2025-09-18T14:14:11.66268Z",
  "updated_at": "2025-09-18T14:14:11.66268Z"
}

Changes