Update Student

PUT /students/{studentId}

Bearer auth

Updates student information.

Path parameters

studentId string Required

The student ID

application/json

Body Required

firstName string | null

First name of the student

Maximum length is 100.
lastName string | null

Last name of the student

Maximum length is 100.
phoneNumber string | null

Phone number of student
avatarUrl string | null

Avatar image URL
status string | null

Student status

Values are active, transferred, graduated, or dropped.

Responses

200 application/json

Student updated successfully
Hide response attributes Show response attributes object
- success boolean
- code integer(int32)
- message string
- data object
  
  API response schema for student returned by student endpoints (includes profile and credentials when applicable)
  
  Hide data attributes Show data attributes object
  
  id string
  
  Unique identifier for the student record
  
  userId string
  
  Associated user/profile id
  
  enrollmentDate string(date) | null
  
  Enrollment date
  
  address string | null
  
  Student address
  
  parentContactEmail string | null
  
  Parent contact email
  
  status string | null
  
  Student status
  
  Values are active, transferred, graduated, or dropped.
  
  createdAt string(date-time) | null
  
  Record creation timestamp
  
  updatedAt string(date-time) | null
  
  Record update timestamp
  
  username string | null
  
  Generated username/email (only set during create/import)
  
  password string | null
  
  Temporary password (only set during create/import)
  
  firstName string | null
  
  First name from user profile
  
  lastName string | null
  
  Last name from user profile
  
  avatarUrl string(uri) | null
  
  Avatar URL from user profile
  
  phoneNumber string | null
  
  Phone number from user profile
400 application/json

Bad Request - Invalid input data
Hide response attributes Show response attributes object
- success boolean
- code integer
- errorCode string
- message string
- timestamp string(date-time)
404 application/json

Student not found
Hide response attributes Show response attributes object
- success boolean
- code integer
- errorCode string
- message string
- timestamp string(date-time)
500 application/json

Internal Server Error
Hide response attributes Show response attributes object
- success boolean
- code integer
- errorCode string
- message string
- timestamp string(date-time)

PUT /students/{studentId}

curl \
 --request PUT 'http://localhost:8080/api/students/{studentId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"firstName":"Nguyen","lastName":"Van A","phoneNumber":"+84987654321","avatarUrl":"https://example.com/avatar.jpg","status":"active"}'

Request examples

{
  "firstName": "Nguyen",
  "lastName": "Van A",
  "phoneNumber": "+84987654321",
  "avatarUrl": "https://example.com/avatar.jpg",
  "status": "active"
}

Response examples (200)

{
  "code": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "status": "active",
    "userId": "user_001",
    "address": "789 Oak Ave",
    "lastName": "Student",
    "password": null,
    "username": null,
    "avatarUrl": "https://example.com/avatar3.jpg",
    "createdAt": "2024-01-15T10:30:00Z",
    "firstName": "Updated",
    "updatedAt": "2024-09-20T14:45:00Z",
    "phoneNumber": "+84990001122",
    "enrollmentDate": "2024-01-15",
    "parentContactEmail": "parent3@example.com"
  },
  "message": "Student updated successfully",
  "success": true
}

Response examples (400)

{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}

Response examples (404)

{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}

Response examples (500)

{
  "success": false,
  "code": 42,
  "errorCode": "string",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z"
}