Item Name (First Column)

The item name column is the first column you see on a board, and it holds the names of your item(s).

πŸ“˜

NOTE

To learn more about querying and mutating items, check out the Items and Items By Column Values sections.

Reading the item name column

The item name does not return in the column_values field. To return the item's name, you need to include the name field in your query.

The name field will return the item's name, and the ID field will return the item ID.

Here is an example payload showing both fields:

{
  "name": "Hello World",
  "id": "2977431914"
}

Updating the item name column

You can update a preexisting item's name with a JSON string. Simple string updates are not supported.

JSON

To update the item's name, send a string between 1 to 255 characters long.

For example: "{\"name\":\"My Item\"}"

Code example

mutation {
  change_multiple_column_values(item_id:11111, board_id:22222, column_values: "{\"name\" : \"My Item\"}") {
    id
  }
}
fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    query : "mutation ($myBoardId:Int!, $myItemId:Int!, $myColumnValues:JSON!) { change_multiple_column_values(item_id:$myItemId, board_id:$myBoardId, column_values: $myColumnValues) { id } }",
    variables : JSON.stringify({
      myBoardId: YOUR_BOARD_ID,
      myItemId: YOUR_ITEM_ID,
      myColumnValues: "{\"name\" : \"My Item\"}"
    })
  })
})
curl "https://api.monday.com/v2" \
-X POST \
-H "Content-Type:application/json" \
-H "Authorization:MY_API_KEY" \
-d '{"query":"mutation{change_multiple_column_values(item_id:162169283, board_id:162169280, column_values:\"{\\\"name\\\" : \\\"My Item\\\"}\"){name}}"}'

πŸ“˜

Do you 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!


Did this page help you?