---
title: "PATCH /api/im/notification-settings"
method: PATCH
path: "/api/im/notification-settings"
tags: ["Im"]
---

# PATCH /api/im/notification-settings

`PATCH /api/im/notification-settings`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/im/notification-settings`
- Auth: HTTP bearer

## Request body

- object
  - `channels` object: Merged into the stored flags.
    - `push` boolean
    - `sms` boolean: Needs a verified phone number.
    - `voice` boolean: Needs a verified phone number.
    - `email` boolean
  - `phoneNumber` string, nullable: E.164, e.g. +491701234567. A new number clears the verification; null or empty removes it.

## Response `200`

Successful response

- object
  - `id` integer, required
  - `phoneNumber` string, nullable, required
  - `phoneVerified` boolean, required
  - `channels` object, required
    - `push` boolean
    - `sms` boolean: Needs a verified phone number.
    - `voice` boolean: Needs a verified phone number.
    - `email` boolean

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)