> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pause media buy

> Halt spend on a single media buy, without touching its campaign or sibling media buys

`POST /api/v2/buyer/media-buys/:mediaBuyId/pause`

Halts spend on exactly one media buy. The media buy transitions to `PAUSED`.

<Note>
  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](/v2/buyer/campaigns/tasks/pause-campaign) instead.
</Note>

<Note>
  To resume, use [reactivate media buy](/v2/buyer/campaigns/tasks/reactivate-media-buy) — pausing does not auto-resume, and there is no separate "unpause" verb.
</Note>

## Request

```bash theme={null}
curl -X POST https://api.interchange.io/api/v2/buyer/media-buys/mb_abc123/pause \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

No request body.

## Parameters

| Field        | Type   | Required | Notes                                                      |
| ------------ | ------ | -------- | ---------------------------------------------------------- |
| `mediaBuyId` | string | Yes      | Media buy ID (path parameter). Must currently be `ACTIVE`. |

## Response

```json theme={null}
{
  "mediaBuyId": "mb_abc123",
  "name": "Q2 2026 Tech Launch - Example Media",
  "previousStatus": "ACTIVE",
  "newStatus": "PAUSED",
  "success": true
}
```

* `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, when `success` is `false` (the buy's own
  status still transitioned even if the downstream ADCP call failed).

## Errors

| Code        | HTTP status | When                                                                                                                 |
| ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------- |
| `CONFLICT`  | 409         | The media buy is not currently `ACTIVE` (error message includes the current status, e.g. `"is PAUSED, not ACTIVE"`). |
| `NOT_FOUND` | 404         | The media buy ID does not exist, or does not belong to the authenticated account.                                    |

See [Errors](/v2/reference/errors) for the full error shape and recovery semantics.

## Related

<CardGroup cols={2}>
  <Card title="Reactivate media buy" href="/v2/buyer/campaigns/tasks/reactivate-media-buy" icon="circle-play">
    Resume this single PAUSED media buy back to ACTIVE
  </Card>

  <Card title="Pause campaign" href="/v2/buyer/campaigns/tasks/pause-campaign" icon="pause">
    Halt spend across every media buy and package on the campaign
  </Card>

  <Card title="Media buy" href="/v2/buyer/campaigns/media-buys" icon="receipt">
    The media buy object, status table, and cascade behavior
  </Card>

  <Card title="Get media buy status" href="/v2/buyer/campaigns/tasks/get-media-buy-status" icon="signal-stream">
    Poll live ADCP status
  </Card>
</CardGroup>