---
title: "Update Email"
method: PATCH
path: "/api/emails/{id}"
tags: ["user"]
---

# Update Email

`PATCH /api/emails/{id}`

## Request

- Base URL: `https://api.git.mari.zip` (the document declares no server; this is the origin it was published from)
- URL: `https://api.git.mari.zip/api/emails/{id}`
- Auth: API key in cookie `gitarena-session`
- TypeScript: <https://skmtc.dev/mari/apis/gitarena/docs/api/emails/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateEmailRequest
  - `notification` boolean, nullable: Receive notifications at this address
  - `primary` boolean, nullable: Set as the primary email (requires the address to be verified)
  - `public` boolean, nullable: Show this address publicly

## Response `200`

Email updated

- Email
  - `commit` boolean, required
  - `email` string, required
  - `id` string, uuid, required
  - `notification` boolean, required
  - `primary` boolean, required
  - `public` boolean, required
  - `verifiedAt` string, date-time, nullable

## Other responses

- `400`: Unverified email cannot be set as primary
- `401`: Authentication required
- `404`: Email not found

## Changes

- **2026-10-29** `efaeb85ac1be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mari/apis/gitarena/changes/api/emails/:id/patch.md)

---

[API](https://skmtc.dev/mari/apis/gitarena.md) - [All operations](https://skmtc.dev/mari/apis/gitarena/llms.txt) - [OpenAPI document](https://skmtc.dev/mari/apis/gitarena/revisions/437eec085d26?raw)