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

# PUT /api/im/notification-settings/channels

`PUT /api/im/notification-settings/channels`

## Request

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

## Request body

- object
  - `channels` object, required: At least one channel. Replaces the rules of each named channel with one rule per urgency at delayMinutes.
    - `push` object
      - `enabled` boolean, required
      - `delayMinutes` integer: Default 0.
    - `sms` object
      - `enabled` boolean, required
      - `delayMinutes` integer: Default 0.
    - `voice` object
      - `enabled` boolean, required
      - `delayMinutes` integer: Default 0.
    - `email` object
      - `enabled` boolean, required
      - `delayMinutes` integer: Default 0.

## Response `200`

Successful response

- object
  - `channels` object, required
    - `push` boolean
    - `sms` boolean: Needs a verified phone number.
    - `voice` boolean: Needs a verified phone number.
    - `email` boolean
  - `rules` object[], required
    - `id` integer, required
    - `urgency` 'high' | 'low', required
    - `delayMinutes` integer, required: Minutes after the page starts.
    - `channel` 'push' | 'sms' | 'voice' | 'email', required

## 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)