POST /v1/projects/:projectId/ads/:platform/content-refresh
Trigger a content refresh — disable underperformers + add the newest eligible creatives.
POST
/v1/projects/:projectId/ads/{platform}/content-refreshPhase 1stableidempotent
- Auth
- Bearer
- Scope
- ads:write:creative
Runs the content-refresh workflow on a layer. The workflow:
- Evaluates running ads, scoring each via the optimizer's
disableUnderperformingAdsActivity(with guardrails: min 3-day age, min $5 spend, never disablesTOP_PERFORMER/HEALTHY, never empties an adset). - Disables the underperformers it found (subject to
creativeaxis bucket-mode). - Picks the newest eligible creatives (newest first; the deprecated creative score is not consulted) from
ads-contentand pushes them. "Eligible" is the same rule that endpoint reports oneligibility: not excluded by override, past safety review and the source container's ad review, not flagged, inside a live TikTok Spark authorization window where one applies, and still backed by its media.
Body
Body
layerIdstring (UUID)requiredRaw UUID of the project’s Ads Manager project layer. In Layers, open Ads → Overview, select the app, and copy layerId from the URL. Do not send adAccountId.maxNewCreativesintegeroptionaldefault: 3Cap on how many fresh creatives to push per adset.
Response
202 { jobId, runId, kind: "content_refresh" }. Long-running (5–10 minutes typical).