---
title: "Update user email"
method: PUT
path: "/api/experimental/users/email"
tags: ["Users"]
---

# Update user email

`PUT /api/experimental/users/email`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/experimental/users/email`
- Auth: API key in header `Coder-Session-Token`

## Request body

- CodersdkUpdateUserEmailRequest
  - `new_email` string, email, required
  - `old_email` string, email, required

## Response `204`

No Content

## Changes

- **2026-09-14** `14d98ed89b65`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coder/apis/coder-api/changes/api/experimental/users/email/put.md)

---

[API](https://skmtc.dev/coder/apis/coder-api.md) - [All operations](https://skmtc.dev/coder/apis/coder-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coder/apis/coder-api/revisions/4669d93796ab?raw)