Layers
Partner APIAPI referenceAds

POST /v1/projects/:projectId/ads/:platform/content-refresh

Trigger a content refresh — disable underperformers + add new top-scored creatives.

View as Markdown
POST/v1/projects/:projectId/ads/{platform}/content-refresh
Phase 1stableidempotent
Auth
Bearer
Scope
ads:write:creative

Runs the content-refresh workflow on a layer. The workflow:

  1. Evaluates running ads, scoring each via the optimizer's disableUnderperformingAdsActivity (with guardrails: min 3-day age, min $5 spend, never disables TOP_PERFORMER/HEALTHY, never empties an adset).
  2. Disables the underperformers it found (subject to creative axis bucket-mode).
  3. Picks new top-scored creatives from ads-content and pushes them.

Body

Body
  • layerId
    stringrequired
  • maxNewCreatives
    integeroptionaldefault: 3
    Cap on how many fresh creatives to push per adset.

Response

202 { jobId, runId, kind: "content_refresh" }. Long-running (5–10 minutes typical).

See also

POST /v1/projects/:projectId/ads/:platform/pending/:pendingId/{approve,reject}

Approve or reject a pending optimizer action queued by the gate's `draft` axes.

POST /v1/projects/:projectId/ads/:platform/disable-underperforming

Disable underperforming ads in bulk across a layer.

On this page

BodyResponseSee also