The item name column is the first column you see on a board, and it holds the names of your item(s). Our API supports this column, so you can read and update the item name column via the API.

📘

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.

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

Updating the item name column

JSON

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

To update the item's name, send a string between 1 to 255 characters long. For example: "{\"name\":\"My Item\"}"

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\"}"
    })
  })
})

You can find the Postman request to change the item's name here.

📘

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!