Bulk Accept or Dismiss Goal Suggestions
POST/api/advertising/goal-suggestions/bulk
Accepts or dismisses up to 1000 goal suggestions in one call. Accepting sets the product's goal to the suggested one (with the suggestion's reason, recorded as set by the advisor); dismissing closes the suggestion, storing the optional reason in its evidence.
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.
Body fields:
ids(required, array of 1 to 1000 distinct existing suggestion IDs).action(required):acceptordismiss.reason(optional, string, max 1000): dismissal reason; ignored when accepting.
Suggestions are processed one by one; one that is no longer open, or whose goal is blocked by a guardrail, is reported as failed without stopping the others. Response data has one row per suggestion: id, ok, error. meta.done and meta.failed count the outcomes.
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 — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
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.