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.

Queries

You can retrieve a board's muted notification settings via the API through the mute_board_settings query.

• Returns 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.

Fields

You can use the following fields to specify what information your mute_board_settings query will return.

Mutations

The API allows you to update a board's mute settings using the following mutation.

Update mute board settings

The update_mute_board_settings mutation updates a specific board's mute notification settings. It returns the [BoardMuteSettings!] type which allows you to specify what fields to query when you run it.

mutation {
  update_mute_board_settings(
    board_id: "1234567890", 
    enabled: IM_ASSIGNED, 
    mute_state: CUSTOM_SETTINGS
  ) {
    enabled
    mute_state
    board_id
  }
}

{
  "data": {
    "update_mute_board_settings": [
      {
        "enabled": [
          "IM_ASSIGNED"
        ],
        "mute_state": "CUSTOM_SETTINGS",
        "board_id": "1234567890"
      }
    ]
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Arguments