Column values v1
Every monday.com board has one or more columns, each of which holds a particular type of information. These column values are essentially the board's content, and their inner value structure varies based on their type.
As a developer working with monday.com, it is important to familiarize yourself with the column_values
API so you know how to access data within columns. This document will walk you through the available queries to read the column_values
object via the API.
Removing column values v1 support
column_values
v1 fields will no longer be supported in API versions2023-10
and later. Check out the updated fields in thecolumn_values
v2 doc!
Queries
Querying column_values
will return metadata about one or a collection of columns. This method accepts one argument and returns an array.
You can only query column_values
by nesting it within another query, so it can't be used at the root. Check out this query in action in our Postman library or follow along with these code samples!
query {
boards (ids: 1234567890) {
items (ids: 9876543210) {
column_values {
value
text
}
}
}
}
let query = "query { boards (ids: 1234567890) { items (ids: 9876543210) { column_values { value text }}}}";
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)));
Pro tip
Want to change column values on your boards? Check out the Columns reference for a full list of mutations or our detailed guide.
Arguments
You can use the following argument(s) to reduce the number of results returned in your column_values
query.
Argument | Description |
---|---|
ids [String] | The specific columns to return. |
Fields
You can use the following field(s) to specify what information your column_values
query will return.
Field | Description |
---|---|
additional_info JSON | The column value's additional information. |
description String | The column's description. |
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. |
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.
Join our developer community!
We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎
Updated about 1 month ago