diff --git a/01.workspace/heave/src/imp/catalog_insert_many.rs b/01.workspace/heave/src/imp/catalog_insert_many.rs
index ae0020f..b65513c 100644
--- a/01.workspace/heave/src/imp/catalog_insert_many.rs
+++ b/01.workspace/heave/src/imp/catalog_insert_many.rs
@@ -14,6 +14,11 @@ impl Catalog {
     /// # Arguments
     ///
     /// * `objects` - A vector of objects to insert or update.
+    ///
+    /// # Errors
+    ///
+    /// Returns `Err(FailedTo)` if any of the underlying `upsert` operations fail.
+    /// This could be due to issues like an object not having a valid ID.
     pub fn insert_many(&mut self, objects: Vec<impl EAV>) -> Result<(), FailedTo> {
         for object in objects {
             self.upsert(object)?;