Skip to main content

Undo Change Set

POST 

/api/advertising/change-sets/:changeSet/undo

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.

Required scope: advertising:write

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

The response is the new undo set (status 201), with reverts_change_set_id pointing at the original and a top-level tracked_job_log_id when it is already being applied.

Body fields:

  • line_ids (optional, array of distinct integers, at least 1 when present): applied lines to undo. Omit (or null) to undo every applied line.

Undoing a set you neither created nor approved additionally requires the advertising.approve permission (otherwise 403). Returns 422 when no listed line was applied.

Requires the advertising.manage permission. Personal access tokens need the advertising:write scope.

Request​

Responses​

Created

Response Headers
    Content-Type