Skip to main content

Goals

📄️List Goal Suggestions

Lists goal suggestions produced by the goal advisor, each with its reason, a one-line `headline` and the `evidence` behind it (days of cover, units available, days since first sale, aged units, oldest age in days, the next long-term-storage-fee date and units, the next inbound purchase order number; a dismissed suggestion also carries `dismissed_reason`, and one that auto mode could not apply carries `auto_blocked`). Only open suggestions are returned unless `status` is given. Sorted newest first by ID. Paginated, 10 per page by default (max 200).

📄️Refresh Goal Suggestions

Starts the goal advisor now instead of waiting for the nightly run. Runs asynchronously as a tracked background job and returns its `tracked_job_log_id` for progress polling. The advisor first ends Launch goals whose launch window is over, then assesses every product advertised in the given ad accounts (or every selected ad account when `ad_account_ids` is omitted or empty) and writes new suggestions; when the goal mode is `auto`, suggestions are applied straight away. Suggestions a person dismissed recently are not repeated.