---
title: "Switch push notification kinds"
method: PUT
path: "/service_agents/me/push_settings"
tags: ["Service Agent"]
---

# Switch push notification kinds

`PUT /service_agents/me/push_settings`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/me/push_settings`
- Auth: none declared

Switches push notification kinds on (`true`) or off (`false`) for the calling agent and returns the
settings after the change. A kind that is not in `kinds` is not changed, and an empty `kinds` changes
nothing. The call is idempotent: sending the same body again gives the same result.

The kinds that can be switched are `chat_mentioned`, `chat_message`, `conversation_message`,
`case_assigned` and `case_note`. Any other key, including the incoming call kinds, is rejected with
`400` (`INVALID_KIND`) before anything is changed.

The kinds are written one by one. When a write fails, the call returns a `5xx` error and the kinds
written before the failure stay changed; send the same request again to finish the change.

A muted chat does not silence `chat_mentioned`: a mention is always delivered while that kind is on.
An agent who switched `chat_mentioned` off gets no notification for a message that mentions him, even
when `chat_message` is on.

## Request body

- object
  - `kinds` object, required: The kinds to switch. The key is the kind and the value is `true` for on and `false` for off.

## Response `200`

The push notification settings after the change.

- PushManagerSettings: The push notification settings of the calling agent.
  - `kinds` object, required: Every kind the agent can switch with `true` for on and `false` for off: `chat_mentioned`, `chat_message`, `conversation_message`, `case_assigned` and `case_note`.
  - `muted_chat_ids` string[], required: The chats the agent muted, the oldest mute first. Empty when no chat is muted.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-11** `690cef25e02a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/me/push_settings/put.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/dbc83827530e?raw)
