# Change email address for an account

Administratively updates the email address for a user account. Can identify the user by username or user ID. The new email must be valid and unique in the system. This operation is logged for audit purposes and the change takes effect immediately.

RBAC: requires Users.Manage

Endpoint: PUT /api/v1/admin/change/email
Version: 1.0
Security: 

## Query parameters:

  - `email` (string, required)
    New email address for the account. Must be a valid email format and unique in the system.

  - `id` (string,null)
    User ID whose email to change. Must be a valid USER type ID. Either username or id must be provided.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `username` (string,null)
    Username of the user whose email to change. Case-insensitive. Either username or id must be provided.

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 200 fields