list_budget_groups

Browse and list all available budget groups in the Metadata platform with customizable sorting.

                Default results include both switched-on and switched-off groups. Omit status for
                inventory and spreadsheet updates; use status=true or status=false only when the user
                requests that switch state. Reading a switched-off group does not switch it on.
                Paginate through totalPages before declaring a named group missing.

                A MONTHLY_RESET or CUSTOM_RESET group starts over every period and keeps funding its campaigns
                until it is switched off; its currentPeriodStart, currentPeriodEnd and remaining days only measure
                the current period, so never present them as the group ending or offer to extend it. Only a
                FIXED_BUDGET group's endDate ends it.

                KEYWORDS: budget, group, list, all, browse, spending, allocation, optimization, overview

                **DIFFERENCE FROM get_budget_group:**
                - get_budget_group: Searches for ONE specific group BY NAME (requires group name input)
                - list_budget_groups: Returns a paginated list of groups (supports flexible sorting)

                USE THIS TOOL WHEN THE USER ASKS:
                - "Show me all budget groups" or "List all budget groups"
                - "What budget groups do we have?"
                - "Display all available groups"
                - "Show groups sorted by [metric]"
                - "Which groups have the highest budget?"
                - "Show groups by leads generated"
                - "List groups sorted by CPL"
                - "Order groups by spending"

                DO NOT USE if the user:
                - Asks for details about a SPECIFIC group by name → use get_budget_group instead
                - Wants to find a group by name → use get_budget_group instead
                - Says "Find the [specific name] group" → use get_budget_group instead

                SORTING OPTIONS:
                You can sort by any of these fields (default: totalActiveExperiments descending):
                - totalActiveExperiments, monthlyCap, averageDailyBudgetPerExperiment
                - spent, totalBudget, endDate, startDate, leads, cpl

                SORT ORDER:
                - asc: Ascending order (lowest to highest, oldest to newest)
                - desc: Descending order (highest to lowest, newest to oldest) [DEFAULT]