Pause or resume a single ad

Pauses or resumes a single ad without touching its ad set, campaign or sibling ads.

Ad-scoped pause/resume: flips ONLY this ad's own switch (Meta configured_status, TikTok operation_status, Google ad group ad status, LinkedIn creative, Pinterest ad, Reddit ad configured_status), never its parent ad set or campaign, so sibling ads keep running. X is the exception: its smallest switch is the line item. Thin wrapper over the status field of PUT /v1/ads/{adId}, for callers that want a URL symmetric to /v1/ads/campaigns/{campaignId}/status and /v1/ads/ad-sets/{adSetId}/status.

The ad's own switch is independent of its delivery status. An ad paused only because its campaign or ad set is off (status: paused, configuredStatus: ACTIVE) can still be switched off here, and switching an ad on under a paused campaign leaves it paused until the campaign is resumed. After the write the switch is read back from the platform and returned as configuredStatus, together with the resulting delivery status.

{adId} accepts the same identifier dialects as GET/PUT /v1/ads/{adId} (Zernio hex _id, Meta numeric platformAdId, or the creative's effective story/media IDs). platform is inferred from the ad, so it's not required in the body. Ads in terminal statuses (rejected, completed, cancelled) are skipped, and so is a request whose target already matches the ad's own switch as read LIVE from the platform (a stored value is never trusted alone, since the switch may have been changed in the platform's own UI). A skip also returns that live read. The rolled-up status never decides a skip.