Mute board settings

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.

ArgumentDescription
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.

FieldDescriptionEnum Values
board_id IDThe board's unique identifier.
mute_state BoardMuteStateThe 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