Profile Management

​

Update Profile

​

Authentication

​

Request Body

​

Response

​

Example

curl -X PATCH https://api.heimdall.dev/api/settings/profile \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"display_name": "Jane Smith"}'

​

Response Example

{
  "status": "ok",
  "data": {
    "success": true,
    "message": "Profile updated."
  }
}

​

Error Responses

​

Change Password

​

Authentication

​

Request Body

​

Response

​

Example

curl -X POST https://api.heimdall.dev/api/settings/change-password \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "current_password": "old_password",
    "new_password": "new_secure_password"
  }'

​

Response Example

{
  "status": "ok",
  "data": {
    "success": true,
    "message": "Password changed successfully."
  }
}

​

Error Responses

• New password is less than 8 characters
• Current password is incorrect

​

Security Notes

• Passwords are hashed using Argon2id before storage
• Current password must be verified before allowing change
• No password complexity requirements beyond minimum length

​

Implementation Reference