diff --git a/hive-forge/src/client.rs b/hive-forge/src/client.rs
index 2cae40b1..2bc0093a 100644
--- a/hive-forge/src/client.rs
+++ b/hive-forge/src/client.rs
@@ -210,6 +210,12 @@ impl Client {
     /// `204 No Content` (empty body), so there is nothing to decode.
     /// Used by `repo-add-collaborator` (Forgejo's add-collaborator PUT
     /// answers 204 on success).
+    ///
+    /// # Errors
+    ///
+    /// Returns an error if the request fails to send (transport/network
+    /// error) or the server responds with a non-2xx status (the response
+    /// body is included in the error).
     pub fn put_no_content<B: Serialize>(&self, path: &str, body: &B) -> Result<()> {
         let url = format!("{}{}", self.api(), path);
         let resp = self