Skip to main content
DELETE /api/v2/buyer/campaigns/:id Archives the campaign, moving it to ARCHIVED status. This is a soft delete — the record is retained for reporting, not permanently removed. Before archiving, Interchange requests full cancellation of the campaign’s active media buys from each seller.

​
Request

​
Parameters

​
Response

204 No Content — no response body. The campaign and all of its media buys and packages are soft-deleted (transitioned to ARCHIVED status). Archived campaigns are excluded from default list results; filter status=ARCHIVED to retrieve them. An archived campaign can be restored from the v3 agent surface with save_campaign({ campaignId, isArchived: false }). It comes back as a DRAFT with a new revision: its media buys were retired when it was archived, so inventory must be staged again before it can launch. There is no v2 REST restore endpoint for campaigns. Campaign deletion is safe to retry when a seller has already removed a full media buy. If the seller returns MEDIA_BUY_NOT_FOUND, Interchange treats that full-buy cancellation as complete and continues archiving the local campaign. This does not apply to cancellation of selected packages: package-only cancellation still returns the seller error and leaves the media buy active so the mismatch can be reviewed.

​
Errors

  • 404 NOT_FOUND — no campaign with this ID is visible to the authenticated account.
  • Seller cancellation failures stop deletion and leave the campaign unarchived. The only exception is MEDIA_BUY_NOT_FOUND while cancelling a full buy, as described above.
See Errors for the full error contract.

Pause campaign

Halt spend without archiving

List campaigns

Filter by status, including ARCHIVED

Campaign tasks

All campaign operations

Campaign overview

Fields, lifecycle, and concepts