---
title: "Change Email"
method: POST
path: "/api/v1/auth/change-email"
tags: ["grandline-auth"]
---

# Change Email

`POST /api/v1/auth/change-email`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/v1/auth/change-email`
- Auth: none declared

Start a Basic→Standard self-upgrade. The new address must be a company
email; we send it a verification link. On confirm (`/verify-email-change`)
the account email is swapped and the tier lifts to Standard. No admin needed.

## Request body

- ChangeEmailRequest
  - `new_email` string, required: A company email; verified before the switch takes effect.

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Authentication required
- `404`: Key not found / not owned by caller
- `422`: Validation Error

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)