---
title: "Turn one kind of notification on or off"
method: PUT
path: "/me/notification-preferences/{kind}/{channel}"
tags: ["Notifications"]
---

# Turn one kind of notification on or off

`PUT /me/notification-preferences/{kind}/{channel}`

## Request

- Base URL: `https://bodylab.lol/api/v1`
- URL: `https://bodylab.lol/api/v1/me/notification-preferences/{kind}/{channel}`
- Auth: HTTP bearer

## Path parameters

- `kind` 'today_session' | 'taper_start' | 'reconnect_needed' | 'weekly_review' | 'pattern_heads_up', required
- `channel` 'push' | 'email', required

## Headers

- `X-Client-Platform` string
- `X-Client-Version` string

## Request body

- object
  - `enabled` boolean, required

## Response `200`

OK

- object
  - `kind` string, required: What the notification is about. Known values: today_session, taper_start, reconnect_needed, weekly_review, pattern_heads_up. Treat unknown values as "other".
  - `channel` string, required: How it's sent. Known values: push, email. Treat unknown values as "other".
  - `enabled` boolean, required: Off until the athlete turns it on.
  - `label` string, required: A short name for the switch, for a person ("Today's session").
  - `description` string, required: What turning it on sends, for a person.

## Other responses

- `401`: Error: UNAUTHORIZED.
- `422`: Error: NOT_OFFERED.

---

[API](https://skmtc.dev/bodylab/apis/body-lab-api.md) · [All operations](https://skmtc.dev/bodylab/apis/body-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bodylab/apis/body-lab-api/revisions/544c201eaf88?raw)