Change Sets
List Change Sets
Lists change sets, newest first (ordered by `id` descending). A change set is a batch of proposed ad changes (bids, budgets, states, ad rates and so on) for one ad account; every write SKU.io makes to an ad platform goes through one, whether it came from a person, a guardrail, a rule, a launch, an undo or a bulksheet import.
Create Change Set
Creates a manual change set for one ad account from a list of changes. Nothing is sent to the ad platform by this call: a manual set always waits for approval (status `pending_approval`, expiring after 48 hours by default) and must be approved with **Approve Change Set**. A dry run (`dry_run: true`) is simulated only and ends in status `simulated`.
Get Change Set
Returns one change set with every line. Each line carries the entity (`entity_type`, `entity_id`, `external_id`, a readable `entity_label`), the `operation`, the `before` and `after` values, its own `status` (`pending`, `applied`, `failed`, `skipped`, `skipped_drift`, `skipped_hold`, `skipped_cap`, `reverted`), any `error`, when it was applied and verified, and the product it concerns.
Approve Change Set
Approves a change set that is pending approval and queues it to be applied to the ad platform. The apply runs in the background: the response has status `approved` and a top-level `tracked_job_log_id` for the apply job (null when the set still needs further approvers). Poll **Get Change Set** for the outcome; after applying, each line is read back from the platform to verify it, and lines whose live value changed outside SKU.io since the set was made are skipped (`skipped_drift`) rather than overwritten.
Reject Change Set
Rejects a change set that is pending approval. Nothing is sent to the ad platform; every pending line is marked `skipped` with the reason, and any open approval request for the set is cancelled.
Revise Change Set
Edits the values of a change set that is pending approval, on the server, and returns the revised copy. You send only the new values; the lines are not re-described. The revised set keeps the original's source, source reference, signal and the holds its lines would create. Its caps, estimated spend delta and approval tier are evaluated again, and it waits for approval (status `pending_approval`); nothing is sent to the ad platform.
Undo Change Set
Reverts an applied (or partially applied) change set, or some of its applied lines, by creating a new change set with source `undo` whose `after` values are each line's original `before` values. The new set goes through the same caps, drift check and approval rules as any other set. If you created or approved the original set (and no approval request is needed) the undo is approved automatically and queued to apply; otherwise it waits for approval. Undoing an undo is allowed.
Retry Failed Change Set Lines
Retries the failed lines of a `failed` or `partially_applied` change set. Failed lines are reset to `pending` and the set is queued to apply again in the background (the drift check runs again, so a line changed outside SKU.io meanwhile is skipped). The response has status `approved` and a top-level `tracked_job_log_id` for the apply job.
Discard Failed Change Set Lines
Gives up on the failed lines of a `failed` or `partially_applied` change set: each failed line becomes `skipped`, keeping its platform error after a 'Discarded by …:' note, so a retry no longer sends it and the set leaves the decision feed. Lines that applied stay applied (undo them separately). The set's own status does not change.
Get Ad Entity Change History
Returns every recorded change to one ad entity, newest first: SKU.io change lines (`kind: sku_change`) merged with changes someone made directly on the ad platform that SKU.io detected during sync (`kind: external_change`). History is kept indefinitely and is not paginated.