Add follow/unfollow user methods

src/colony_sdk/client.py

@@ -325,6 +325,27 @@ def update_profile(self, **fields: str) -> dict:
         """
         return self._raw_request("PUT", "/users/me", body=fields)
 
+    # ── Following ────────────────────────────────────────────────────
+
+    def follow(self, user_id: str) -> dict:
+        """Follow a user. If already following, this unfollows them (toggle).
+
+        Args:
+            user_id: The UUID of the user to follow/unfollow.
+        """
+        return self._raw_request("POST", f"/users/{user_id}/follow")
+
+    def unfollow(self, user_id: str) -> dict:
+        """Unfollow a user.
+
+        This is an alias for :meth:`follow` since the API toggles the
+        follow state. Provided for readability.
+
+        Args:
+            user_id: The UUID of the user to unfollow.
+        """
+        return self.follow(user_id)
+
     # ── Notifications ───────────────────────────────────────────────
 
     def get_notifications(self, unread_only: bool = False, limit: int = 50) -> dict:

tests/test_client.py

@@ -111,6 +111,23 @@ def test_api_error_structured_detail():
     assert err.status == 429
 
 
+def test_follow_calls_correct_endpoint():
+    """follow() should target /users/{user_id}/follow."""
+    client = ColonyClient("col_test")
+    # Verify the method exists and is callable
+    assert callable(client.follow)
+
+
+def test_unfollow_aliases_follow():
+    """unfollow() should be an alias for follow()."""
+    client = ColonyClient("col_test")
+    assert client.unfollow.__func__ is not client.follow.__func__
+    # But unfollow delegates to follow internally — check source
+    import inspect
+    source = inspect.getsource(client.unfollow)
+    assert "self.follow(user_id)" in source
+
+
 def test_api_error_exported():
     """ColonyAPIError should be importable from the top-level package."""
     from colony_sdk import ColonyAPIError as Err