Learn how to read a board’s muted notification settings via the platform API
Notifications are a core part of monday.com, helping users and teams stay up-to-date on important changes, assignments, and mentions. However, there are times when users or board owners may want to reduce noise by muting notifications for specific boards.
🚧 The `mute_board_settings` query is only available in API versions 2025-10 and later
Queries
You can retrieve a board's muted notification settings via the API through the mute_board_settings
query.
- Returns metadata for a board's muted notification settings
- Can only be queried at the root; cannot be nested within another query
query {
mute_board_settings (board_ids: 1234567890) {
board_id
mute_state
}
}
{
"data": {
"mute_board_settings": [
{
"board_id": "1234567890",
"mute_state": "CURRENT_USER_MUTE_ALL"
}
]
},
"extensions": {
"request_id": "YOUR_REQUEST_ID"
}
}
Arguments
You can use the following arguments to reduce the number of results returned in your mute_board_settings
query.
Argument | Description |
---|---|
board_ids [ID!]! | The unique identifiers of the boards to retrieve mute settings for. |
Fields
You can use the following fields to specify what information your mute_board_settings
query will return.
Field | Description | Enum Values |
---|---|---|
board_id ID | The board's unique identifier. | |
mute_state BoardMuteState | The board's mute state. | • CURRENT_USER_MUTE_ALL : current user has all notifications muted• MENTIONS_AND_ASSIGNS_ONLY : current user is only notified when mentioned or assigned something• MUTE_ALL : board owner has all notifications for all users are muted• NOT_MUTED : board owner has nothing muted for all users |