MMetadata /docs
⌘K
Docs/Tools/update_experiments_daily_budgets

update_experiments_daily_budgets

Update daily budget allocations for one or more experiments in the Metadata platform.

Destructive campaigns

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Update daily budget allocations for one or more experiments in the Metadata platform.

                KEYWORDS: experiment, budget, daily, update, change, adjust, spending, allocation, modify

                WHEN TO USE:
                - User wants to "change the daily budget for experiment X"
                - User asks to "adjust daily budget for experiments A, B, C"
                - User requests to "update experiment budgets"
                - User wants to "allocate more budget to experiment Y"
                - User asks to "set daily budget to X for multiple experiments"

                PURPOSE:
                This tool allows you to adjust the daily budget amount for active experiments.
                The daily budget controls how much money each experiment can spend per day.

                REQUIRED PARAMETERS:
                - budgets: A dictionary mapping experiment IDs to their new daily budget values

                BUDGET VALUE FORMAT:
                Budget values can be provided as:
                - Strings with comma separator (European format): "100,50" → 100.50
                - Strings with dot separator (US format): "100.50" → 100.50
                - Numbers: 100, 100.5, 100.50
                - All values are automatically converted to 2 decimal places

                INPUT EXAMPLES:
                - Single experiment: {"budgets": {"12345": "100.50"}}
                - Multiple experiments: {"budgets": {"12345": 100.50, "12346": "150,75", "12347": 200}}

                INTEGRATION WITH OTHER TOOLS:
                - Use search_experiments to find the experiment IDs to update the daily budget.

Arguments

ArgumentTypeNotes
budgets object required Dictionary mapping experiment IDs to new daily budget values. Keys are experiment IDs (integers or strings), values are budget amounts (numbers or strings with comma/dot separators). Example: {'12345': 100.50, '12346': '150,75'}

Request

Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_experiments_daily_budgets","arguments":{"budgets":{}}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other campaigns tools:

Browse the tool catalog · machine-readable index