Learn about the other types used when creating, updating, and deleting board views via the API
The monday.com views
API lets you query a board view's configuration, appearance, and settings.
Each of the object types described below represents a specific aspect of a board view. You can use these object types to supply metadata in mutations.
ItemsQueryGroup
An object containing a group of filtering rules.
Field | Description | Enum Values | Supported Fields |
---|---|---|---|
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. | column_id ID! compare_attribute String compare_value CompareValue! operator ItemsQueryRuleOperator |
ItemsQueryRule
The rules to filter your queries by specific columns.
Field | 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 | 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 | Description | Supported Fields |
---|---|---|
columns ColumnsConfigInput | The table view's column visibility configuration. | column_order [String!] column_properties [ColumnPropertyInput!] floating_columns_count Int subitems_column_properties [ColumnPropertyInput!] |
group_by GroupBySettingsInput | The table view's grouping conditions. | conditions [GroupByConditionInput!]! hideEmptyGroups Boolean |
ColumnConfigInput
The column visibility and display order configuration.
Field | 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 | 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 | Description | Supported Fields |
---|---|---|
conditions [GroupByConditionInput!]! | The list of item grouping conditions. | columnId String! config GroupByColumnConfigInput |
hideEmptyGroups Boolean | Whether to hide empty groups without items. |
GroupByConditionInput
The list of item grouping conditions.
Field | Description | Supported Fields |
---|---|---|
columnId String! | The column's unique identifier. | |
config GroupByColumnConfigInput | The column's sort settings. | sortSettings GroupBySortSettingsInput |
GroupByColumnConfigInput
The group's column sort settings.
Field | Description | Supported Fields |
---|---|---|
sortSettings GroupBySortSettingsInput | The column's sort settings. | direction SortDirection! type String |
GroupBySortSettingsInput
The direction and type of sort.
Field | Description | Enum Values |
---|---|---|
direction SortDirection! | The group's sort direction. | ASC DESC |
type String | The type of sorting to apply. |