Docs
APIAPI referenceAds

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

Disable underperforming ads in bulk across a layer.

View as Markdown
POST/v1/projects/:projectId/ads/{platform}/disable-underperforming
Phase 1stableidempotent
Auth
Bearer
Scope
ads:write:lifecycle

Same scoring + guardrails as the content-refresh workflow's first step, but skips the new-creative push. Use when you want a "kill the bad ones" pass without immediately replacing them.

Body

Body
  • layerId
    string (UUID)required
    Raw 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.
  • dryRun
    booleanoptionaldefault: false
    If true, returns the list of ads that *would* be disabled but does not dispatch.

Authority: each disable goes through the creative axis gate.

Guardrails (cannot be overridden)

  • Min ad age: 3 days.
  • Min spend: $5.00.
  • Never disables TOP_PERFORMER or HEALTHY ads.
  • Never leaves an adset/adgroup empty.

See also

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

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

Recommendations

Layers-generated suggestions (content strategy, ad creative, etc.) scoped to a project.

On this page

BodyGuardrails (cannot be overridden)See also