Endpoint to update Users

🛠️ Update Users

📋 Endpoints Required

• PUT /api/v1/users/:id — Update resource

🗂️ Data Schema

Describe or paste the expected request/response shape below.

{
  email: string,
  username: string,
  newPassword: string,
  oldPassword: string <Required if newPassword is present, otherwise optional>,
  firstName: string,
  lastName: string,
  active: boolean
}

✅ Acceptance Criteria

• All endpoints return correct HTTP status codes
• Input validation is applied to request bodies and query params
• Errors return consistent, descriptive JSON responses
• Endpoints are protected by appropriate auth/authorization middleware
• Pagination supported on the list endpoint
• Unit tests cover each endpoint (happy path + error cases)
• Integration tests pass in CI
• OpenAPI / Swagger docs updated

🔒 Auth & Permissions

🔗 Related

💬 Additional Context

Start from the API route or controller for PUT /api/v1/users/:id and inspect the existing user endpoint patterns. Confirm request validation, status codes, JSON errors, and unit or integration test coverage against the listed schema; authentication middleware and OpenAPI documentation remain unspecified and unchecked.