Column values
Every monday.com board has one or more columns, each of which holds a particular type of information. These column values are essentially the content of the board, and their inner value structure varies by their type.
Column values queries
Column values are available for querying through parent items. They must be nested within another query, like an item. You cannot use them at the root of your query.
You can find the Postman request to get column values from an item here.
query {
boards (limit: 5) {
items (limit: 50) {
column_values {
id
value
}
}
}
}
let query = "query { items (limit: 50) { column_values { id value }}}";
fetch ("https://api.monday.com/v2", {
method: 'post',
headers: {
'Content-Type': 'application/json',
'Authorization' : 'YOUR_API_KEY_HERE'
},
body: JSON.stringify({
query : query
})
})
.then(res => res.json())
.then(res => console.log(JSON.stringify(res, null, 2)));
Want to change column values on your boards?
Check out the Columns reference for a full list of mutations, or our detailed guide.
Arguments
The following column values argument can reduce the number of values returned.
Argument | Description |
---|---|
ids [String] | A list of the unique column identifier(s). |
Fields
The following fields will determine what information is returned from your column_values()
queries.
Field | Description |
---|---|
additional_info JSON | The column value's additional information. |
id ID! | The column's unique identifier. |
text String | The column's textual value. |
title String! | The column's title. |
type String! | The column's type. |
value JSON | The column's value in JSON format. |
description String | The column's description. |
Please note: we do not currently support using aliases in the additional_info
and text
fields. Doing so will return null or an empty result.
Have questions?
Join our developer community! You can share your questions and learn from fellow users and monday.com product experts.
Donβt forget to search before opening a new topic!
Updated 5 days ago