Updates Methods

Method Name Method Type Description
get_item_updates(item_id) Getter Retrieves all updates from an item.
create_update(item_id, update_text) Setter Creates an update on an item.
create_reply(item_id, update_text, parent_id) Setter Creates a reply to an existing update.
delete_update(update_id) Deleter Deletes an update on an item.
clear_updates(item_id) Deleter Clears all updates from an item.

Method Details

get_item_updates()

get_item_updates(item_id)

Description: Retrieves all updates from an item.

Arguments:

  • item_id (int): ID of the item to fetch updates from.

Returns: List of updates containing update text, timestamps, creator ID, replies, and assets. Returns None or an error message if the request fails.

Example:

updates = monday.updates.get_item_updates(123456789)

create_update()

create_update(item_id, update_text)

Description: Creates an update on an item.

Arguments:

  • item_id (int): ID of the item to post the update on.
  • update_text (str): The text content of the update.

Returns: The ID of the newly created update. Returns None or an error message if the request fails.

Example:

update_id = monday.updates.create_update(123456789, "This is an update.")

create_reply()

create_reply(item_id, update_text, parent_id)

Description: Creates a reply to an existing update.

Arguments:

  • item_id (int): ID of the item where the update exists.
  • update_text (str): The text content of the reply.
  • parent_id (int): ID of the update being replied to.

Returns: The ID of the newly created reply. Returns None or an error message if the request fails.

Example:

reply_id = monday.updates.create_reply(item_id=123456789, 
                                       update_text="This is a reply", 
                                       parent_id=987654321)

delete_update()

delete_update(update_id)

Description: Deletes an update on an item.

Arguments:

  • update_id (int): ID of the update to delete.

Returns: True if the update was deleted successfully. Returns None or an error message if the request fails.

Example:

success = monday.updates.delete_update(987654321)

clear_updates()

clear_updates(item_id)

Description: Clears all updates from an item.

Arguments:

  • item_id (int): ID of the item to clear updates from.

Returns: True if all updates were cleared successfully. Returns None or an error message if the request fails.

Example:

success = monday.updates.clear_updates(123456789)