POST /api/v2/buyer/media-buys/:mediaBuyId/pause
Halts spend on exactly one media buy. The media buy transitions to PAUSED.
This does not cascade. It touches only the targeted media buy — never the
parent campaign row and never any sibling media buy on the same campaign. To
pause every media buy on a campaign at once, use
pause campaign instead.
To resume, use reactivate media buy — pausing does not auto-resume, and there is no separate “unpause” verb.
Request
Parameters
Response
mediaBuyId— the media buy that was paused.name— the media buy’s display name.previousStatus/newStatus— status before and after the call.success— whether the ADCP pause call to the sales agent succeeded.error— present, with a message, whensuccessisfalse(the buy’s own status still transitioned even if the downstream ADCP call failed).
Errors
See Errors for the full error shape and recovery semantics.
Related
Reactivate media buy
Resume this single PAUSED media buy back to ACTIVE
Pause campaign
Halt spend across every media buy and package on the campaign
Media buy
The media buy object, status table, and cascade behavior
Get media buy status
Poll live ADCP status