Method add_group

tests/utils/api_client.py:683–695

Add a group and return its positional groupId. project.group.add doesn't echo the new id; the positional groupId is the last array index in project.group.list. Use this with the project.group.* (positional) handlers. For uniqueId-based handlers (workspace re

(self, title: str = "Group", widget_type: int = 0)

        return self.command("project.action.list").get("actions", [])

    def add_group(self, title: str = "Group", widget_type: int = 0) -> int:
        """
        Add a group and return its positional groupId.

        project.group.add doesn't echo the new id; the positional groupId is
        the last array index in project.group.list. Use this with the
        project.group.* (positional) handlers. For uniqueId-based handlers
        (workspace refs, dataset.xAxisId, ...) read `uniqueId` from
        project.group.list yourself.
        """
        self.command("project.group.add", {"title": title, "widgetType": widget_type})
        groups = self.list_groups()
        return len(groups) - 1 if groups else -1

    def update_group(self, group_id: int, **fields) -> dict:
        """PATCH a group (title, widget, columns, sourceId, painterCode, ...)."""