Update Bid Strategy

Change campaign bidding strategy.

Available Strategies:

MAXIMIZE_CLICKS: Get as many clicks as possible within budget
MAXIMIZE_CONVERSIONS: Get as many conversions as possible
TARGET_CPA: Set a target cost per acquisition (requires target_cpa)
TARGET_ROAS: Set a target return on ad spend (requires target_roas)

Parameters:

campaign_id: The campaign ID (REQUIRED)
strategy: MAXIMIZE_CLICKS, MAXIMIZE_CONVERSIONS, TARGET_CPA, or TARGET_ROAS (REQUIRED)
target_cpa: Required if strategy is TARGET_CPA. In dollars, e.g., 25.00 for $25 CPA
target_roas: Required if strategy is TARGET_ROAS. Multiplier, e.g., 4.0 for 400% ROAS
customer_id: Optional (uses connected account if omitted)

IMPORTANT:

TARGET_CPA requires conversion tracking to be set up
TARGET_ROAS requires conversion value tracking
Changing strategy may take 1-2 weeks to stabilize performance
Confirm with user before changing

Execution time: 2-4 seconds

Example: User: “I want to target $30 CPA” Agent:

Confirms: “I’ll change the bidding strategy to TARGET_CPA with a $30 target. This may take 1-2 weeks to optimize. Proceed?”
Uses update_bid_strategy with strategy=TARGET_CPA, target_cpa=30.00

POST

/

api

/

v1

/

tools

/

update_bid_strategy

/

execute

Update Bid Strategy

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/update_bid_strategy/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "<campaign_id>",
    "customer_id": "string",
    "strategy": "string",
    "target_cpa": 1,
    "target_roas": 1
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for update_bid_strategy)"
  },
  "success": true,
  "tool": "update_bid_strategy"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for updating campaign bidding strategy

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Update CampaignUpdate an existing campaign's settings. **Can update:** - name: Campaign name - status: ENABLED or PAUSED - budget_amount: Daily budget in dollars **IMPORTANT:** - Confirm with user BEFORE making changes - Use list_campaigns first to get campaign_id - At least one field (name, status, or budget_amount) is required **Parameters:** - campaign_id: The campaign ID (REQUIRED - get from list_campaigns) - name: New campaign name (optional) - status: ENABLED or PAUSED (optional) - budget_amount: Daily budget in dollars, e.g., 50.00 for $50/day (optional) - customer_id: Optional (uses connected account if omitted) **Execution time:** 2-4 seconds **Example:** User: "Increase the budget to $100/day" Agent: 1. Uses list_campaigns to find the campaign 2. Confirms with user: "I'll update 'Summer Sale' budget from $50 to $100/day. Proceed?" 3. Uses update_campaign with campaign_id and budget_amount=100.00

Update Bid Strategy

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/update_bid_strategy/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "<campaign_id>",
    "customer_id": "string",
    "strategy": "string",
    "target_cpa": 1,
    "target_roas": 1
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for update_bid_strategy)"
  },
  "success": true,
  "tool": "update_bid_strategy"
}