Update Optimizer Settings
PUT/api/advertising/optimizer/settings
Sets the bid optimizer mode and returns the full optimizer settings (same shape as Get Optimizer Settings). The change is recorded in the activity log.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.manage permission; the tenant must have the advertising-manager feature enabled. Setting auto additionally requires the advertising.approve permission (403 otherwise) and a recent backtest that beats the bid-to-target-POAS rule on contribution; without one the request is refused with a 422 under errors.optimizer_mode explaining what to do.
Modes: off (no scheduled runs), monitor (estimates only, no change sets), suggest (each run creates a pending change set for review), auto (change sets are applied without review).
Body fields:
optimizer_mode(required): off, monitor, suggest or auto.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.