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

# Update Insertion Order Status

> Enables, pauses, archives, or permanently deletes DV360 insertion orders

Enables, pauses, archives, or permanently deletes DV360 insertion orders. DELETED cannot be undone and requires the insertion order to be archived first.

|                       |                                       |
| --------------------- | ------------------------------------- |
| **App**               | DV360                                 |
| **Operation ID**      | `dv360_update_insertion_order_status` |
| **Type**              | Action                                |
| **Connection**        | `dv360` (required)                    |
| **Credits per run**   | 1                                     |
| **Agent / MCP tool**  | Yes                                   |
| **Requires approval** | Yes (write operation)                 |

## Inputs

| Field                | Type                                          | Required | Default | Description                                                                                                                                                                                                                                       |
| -------------------- | --------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`            | DynamicAccount                                | Yes      | -       | Select DV360 advertiser account to update insertion orders in                                                                                                                                                                                     |
| `update_type`        | string or SelectableOption                    | Yes      | -       | Choose whether to update a single insertion order or multiple insertion orders at once. Options: 'single' (Single Update), 'bulk' (Bulk Updates)                                                                                                  |
| `insertion_order_id` | string                                        | No       | -       | The insertion order ID to update (required for single update)                                                                                                                                                                                     |
| `status`             | string or SelectableOption                    | No       | -       | Select the new status for the insertion order. Options: 'ACTIVE', 'PAUSED', 'ARCHIVED', 'DELETED' (required for single update). DELETED permanently deletes the insertion order and cannot be undone; the insertion order must be ARCHIVED first. |
| `structured_data`    | array (also accepts a comma-separated string) | No       | -       | Structured data with 'insertion\_order\_id' and 'status' fields for each row (required for bulk update)                                                                                                                                           |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `str`

Returns success message confirming insertion order status update.