monday.com updates contain additional notes and information added to items outside of their columns. The main form of communication within the platform takes place in the updates section.

Updates queries

Required scope: updates:read

You can use updates at the root of your query or nest them within another query. Querying updates directly returns all updates across an account.

You can also nest updates within a board query to return all updates from a specific board.

query {
    updates (limit: 100) {
        body
        id
    created_at
    creator {
      name
      id
    }
  }
}

let query = "query {updates (limit: 100) { body id  created_at  creator { name id } }}";

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)));

Arguments

The following arguments can reduce the number of updates returned.

Fields

Fields are used to return specific properties in an object. The following fields will determine what information is returned from your updates queries.

📘

NOTE

At this time, querying updates will return them in descending order, from the most recently created update to the "oldest" update. The maximum amount of updates that can be retrieved via API is 10,000.

Updates mutations

Required scope: updates:write

Create an update

The create_update() mutation allows one to add an update to an item. After the mutation runs, you can query back the update data as shown in the querying updates section above.

mutation {
    create_update (item_id: 20178755, body: "This update will be added to the item") {
        id
    }
}

let query = "mutation {create_update (item_id: 1215034944, body: \"This update will be added to the item\") { id }}";

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)));

You can find the Postman request to create an update here.

Arguments for create an update

The following arguments define the new update's characteristics.

Delete an update

The delete_update() mutation allows you to delete an update of an item. After the mutation runs you can query back the remaining updates data as shown in the querying updates section above.

mutation {
    delete_update (id: 20178755) {
        id
    }
}

let query = "mutation { delete_update (id: 988712387) { id }}";

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)));

Arguments for delete an update

The following argument determines which update to delete.

📘

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!