---
title: "Turn one of Runtime's optional emails on or off for this key's person."
method: POST
path: "/v1/account/emails:update"
tags: ["account"]
---

# Turn one of Runtime's optional emails on or off for this key's person.

`POST /v1/account/emails:update`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/account/emails:update`
- Auth: HTTP bearer

Only the key's own person, in this account; the account's notices (GET /v1/notices) and webhooks are unchanged.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `category` 'own-deletions' | 'billing' | 'usage' | 'tips', required
  - `enabled` boolean, required

## Response `200`

Success

- object
  - `settings` object[], required
    - `category` 'own-deletions' | 'billing' | 'usage' | 'tips', required: own-deletions: deletion warnings for dates the account's own retention set; billing: credit running low or out; usage: the month's free usage at 80% and all; tips: getting-started emails.
    - `enabled` boolean, required: false: the email stops, for this person only.
    - `updatedAt` string, date-time, nullable, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)