Skip to main content

List Guardrail Policies

GET 

/api/advertising/guardrail-policies

Lists every guardrail policy: the tenant default first, then by scope type and ID. A policy sets the guardrail thresholds and automation mode (off, monitor, suggest, auto) for a scope: tenant, platform (scope_id is a platform value), ad_account, campaign, brand or product (scope_id is that record's ID). For a given product and account, the more specific policies override the less specific ones field by field. Each row includes affected_products, the number of evaluated products the policy's scope covers. Not paginated.

Required scope: advertising:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Filters: filter[scope_type] (or scope_type) and filter[mode] (or mode); unknown values are ignored.

last_dry_run_results holds the latest 7-day replay (proposed changes, products affected, estimated spend saved, signal counts by type and up to a sample of the changes). auto_unlocked_until is when that dry run stops counting for switching the policy to auto (7 days after it ran).

Requires the advertising.view permission. Personal access tokens need the advertising:read scope.

Request​

Responses​

OK

Response Headers
    Content-Type