The monday.com views APIs enable you to create, read, update, and delete board views.

The types below are used by the views queries and mutations, and are not independently queryable.

ItemsQueryGroup

An object containing a group of filtering rules.

Field	Type	Description	Enum Values
groups	`[ItemsQueryGroup!]`	The rule groups to filter your queries.
operator	`ItemsQueryOperator`	The operator to use for the rule groups. The default is `and`.	`and` `or`
rules	`[ItemsQueryRule!]`	The rules to filter your queries.

ItemsQueryRule

The rules to filter your queries by specific columns.

Field	Type	Description	Enum Values
column_id	`ID!`	The unique identifier of the column to filter by.
compare_attribute	`String`	The comparison attribute. You can find the supported attributes for each column type in the column types reference. Most columns don't have a `compare_attribute`.
compare_value	`CompareValue!`	The column value to filter by. This can be a `string` or index value depending on the column type. You can find the supported values for each column type in the column types reference.
operator	`ItemsQueryRuleOperator`	The condition for value comparison. The default is `any_of`.	`any_of` `not_any_of` `is_empty` `is_not_empty` `greater_than` `greater_than_or_equals` `lower_than` `lower_than_or_equal` `between` `not_contains_text` `contains_text` `contains_terms` `starts_with` `ends_with` `within_the_next` `within_the_last`

ItemsQueryOrderBy

The column attributes to sort results by.

Field	Type	Description	Enum Values
column_id	`String!`	The unique identifier of the column to filter or sort by. You can also enter `\"__creation_log__\"` or `\"__last_updated__\"` to chronologically sort results by their last updated or creation date (oldest to newest).
direction	`ItemsOrderByDirection`	The direction to sort items in. The default is `asc`.	`asc` `desc`

TableViewSettingsInput

An object containing the table view setting's configuration.

Field	Type	Description
columns	`ColumnsConfigInput`	The table view's column visibility configuration.
group_by	`GroupBySettingsInput`	The table view's grouping conditions.

ColumnConfigInput

The column visibility and display order configuration.

Field	Type	Description
column_order	`[String!]`	The order of the columns.
column_properties	`[ColumnPropertyInput!]`	The columns' configuration.
floating_columns_count	`Int`	The number of floating columns to display.
subitems_column_properties	`[ColumnPropertyInput!]`	The subitem columns' configuration.

ColumnPropertyInput

The column visibility configuration.

Field	Type	Description
column_id	`String!`	The column's unique identifier.
visible	`Boolean!`	Whether the column is visible.

GroupBySettingsInput

The table view's grouping and visibility conditions.

Field	Type	Description
conditions	`[GroupByConditionInput!]!`	The list of item grouping conditions.
hideEmptyGroups	`Boolean`	Whether to hide empty groups without items.

GroupByConditionInput

The list of item grouping conditions.

Field	Type	Description
columnId	`String!`	The column's unique identifier.
config	`GroupByColumnConfigInput`	The column's sort settings.

GroupByColumnConfigInput

The group's column sort settings.

Field	Type	Description
sortSettings	`GroupBySortSettingsInput`	The column's sort settings.

GroupBySortSettingsInput

The direction and type of sort.

Field	Type	Description	Enum Values
direction	`SortDirection!`	The group's sort direction.	`ASC` `DESC`
type	`String`	The type of sorting to apply.

ViewContext

🚧
Only available in API versions 2026-10 and later

The view's entity scope, passed to create_view, create_view_table, update_view, and update_view_table via the context argument. The default is BOARD.

Enum value	Description
`BOARD`	Associates the view with the board.

ConditionalFormattingConditionInput

🚧
Only available in API versions 2026-10 and later

A conditional formatting condition, passed to create_view, create_view_table, update_view, and update_view_table via the conditional_formatting_settings argument. Each condition pairs a set of rules with a target and a highlight color: when an item matches the rules, the target cells or row are highlighted.

Passing conditional_formatting_settings replaces all existing conditions on the view. Pass an empty array to clear them.

Field	Type	Description
formatting	`ConditionalFormattingFormattingInput`	The formatting to apply when the condition matches.
id	`String`	The condition's unique identifier. Generate a GUID on the client.
rules	`[ConditionalFormattingRuleBucketInput!]`	The rules that trigger the condition.
target	`ConditionalFormattingTargetInput`	What to highlight when the condition matches.

The example below highlights the entire row in dark_red when the status column is set to the label with index 2.

mutation {
  create_view_table(
    board_id: 1234567890
    name: "Stuck items"
    conditional_formatting_settings: [
      {
        id: "3f2b9c1e-8a4d-4f6e-9b2a-7c5d1e0f4a3b"
        rules: [
          {
            type: "RULE"
            operator: "ANY_OF"
            rule: {
              type: "BOARD_COLUMN"
              context: {
                board_id: 1234567890
                column_id: "status"
                column_type: "color"
              }
              compare_value: [2]
            }
          }
        ]
        target: { entire_row: true }
        formatting: { highlight_color: ["dark_red"] }
      }
    ]
  ) {
    id
    name
  }
}

ConditionalFormattingRuleBucketInput

🚧
Only available in API versions 2026-10 and later

A bucket of conditional formatting rules, referenced by ConditionalFormattingConditionInput.

Field	Type	Description
operator	`String`	The logical operator, such as `ANY_OF` or `ALL_OF`.
rule	`ConditionalFormattingRuleInput`	The rule definition.
type	`String`	The bucket type, such as `RULE`.

ConditionalFormattingRuleInput

🚧
Only available in API versions 2026-10 and later

A conditional formatting rule, referenced by ConditionalFormattingRuleBucketInput.

Field	Type	Description
compare_value	`JSON`	The values to match against. For status columns, pass an array of label indexes (for example, `[2]`).
context	`ConditionalFormattingRuleContextInput`	The column the rule evaluates.
type	`String`	The rule type, such as `BOARD_COLUMN`.

ConditionalFormattingRuleContextInput

🚧
Only available in API versions 2026-10 and later

The column a conditional formatting rule evaluates, referenced by ConditionalFormattingRuleInput.

Field	Type	Description
board_id	`ID`	The unique identifier of the board the column belongs to.
column_id	`String`	The unique identifier of the column to evaluate.
column_type	`String`	The column's type, such as `color`, `text`, or `date`.
compare_attribute	`String`	The column attribute to compare against.

ConditionalFormattingTargetInput

🚧
Only available in API versions 2026-10 and later

What a conditional formatting condition highlights, referenced by ConditionalFormattingConditionInput.

Field	Type	Description
column_ids	`[String!]`	The unique identifiers of the columns to highlight.
entire_row	`Boolean`	Whether to highlight the entire row.

ConditionalFormattingFormattingInput

🚧
Only available in API versions 2026-10 and later

The formatting a conditional formatting condition applies, referenced by ConditionalFormattingConditionInput.

Field	Type	Description
highlight_color	`[String!]`	The color names to highlight with, such as `["orange"]` or `["dark_red", "done-green"]`.