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

# How do I pause an order and resume it later?

> PUT /api/v1/orders/{order_id}/pause holds an order indefinitely. PUT /orders/{order_id}/pause/{YYYY-MM-DD} holds it until a date and then auto-unpauses. PUT /orders/{order_id}/unpause resumes it and restores the prior status.

Pausing holds an order in place without cancelling it. Use `PUT /api/v1/orders/{order_id}/pause` for an indefinite hold, or `PUT /api/v1/orders/{order_id}/pause/{date}` to hold until a calendar date, at which point the order unpauses itself. Both are valid only from `received` or `exception`.

```bash theme={null}
# Hold indefinitely
curl -X PUT https://api.byblend.com/api/v1/orders/ORD250312003548IAU4/pause \
  -H "Authorization: Bearer {access_token}"

# Hold until September 15
curl -X PUT https://api.byblend.com/api/v1/orders/ORD250312003548IAU4/pause/2026-09-15 \
  -H "Authorization: Bearer {access_token}"
```

## Resuming

```bash theme={null}
curl -X PUT https://api.byblend.com/api/v1/orders/ORD250312003548IAU4/unpause \
  -H "Authorization: Bearer {access_token}"
```

Unpausing restores the order's **prior status** and clears `paused_until`. It's valid only from `paused`.

## How the timed pause behaves

* The order **automatically unpauses** when that date arrives — you don't need to call anything.
* `paused_until` is `null` when the pause is indefinite, or when the order isn't paused.
* Calling pause-until again on an already-paused order **updates** the date rather than erroring.

<Warning>
  A date in the past, or a format other than `YYYY-MM-DD`, returns a `400`.
</Warning>

## What pausing does and doesn't do

Pausing stops fulfillment. It does not cancel the order, release the prescription's fills, or notify the patient. The order retains its line items and its prescription links, and picks up exactly where it left off.

<Tip>
  Pausing an order is different from a prescription being **too early to fill**. That's an automatic hold Blend applies based on the patient's remaining supply, and it resolves on its own — see [stuck orders](/guides/stuck-orders).
</Tip>

<CardGroup cols={2}>
  <Card title="Pause an order" icon="pause" href="/api-reference/orders/pause-an-order">
    Indefinite hold
  </Card>

  <Card title="Pause an order until a date" icon="calendar" href="/api-reference/orders/pause-an-order-until-a-date">
    Auto-unpauses on the date
  </Card>

  <Card title="Unpause an order" icon="play" href="/api-reference/orders/unpause-an-order">
    Restores the prior status
  </Card>

  <Card title="Cancel an order" icon="ban" href="/api-reference/orders/cancel-an-order">
    When it shouldn't ship at all
  </Card>
</CardGroup>