Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
Deletes an insertion order. Returns error code NOT_FOUND if the insertion order does not exist. The insertion order should be archived first, i.e. set entityStatus to ENTITY_STATUS_ARCHIVED, to be able to delete it.
[null,null,["Last updated 2025-04-02 UTC."],[[["\u003cp\u003eDeletes an existing insertion order that has been archived (\u003ccode\u003eENTITY_STATUS_ARCHIVED\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the advertiser ID and the insertion order ID in the request path.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP DELETE request with an empty request body to perform the deletion.\u003c/p\u003e\n"],["\u003cp\u003eReturns an empty response body upon successful deletion and a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error if the insertion order doesn't exist.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["To delete an insertion order, send a `DELETE` HTTP request to the specified URL, including the `advertiserId` and `insertionOrderId` as path parameters. The insertion order must be archived beforehand by setting its `entityStatus` to `ENTITY_STATUS_ARCHIVED`. The request body should be empty. A successful deletion returns an empty JSON object. The required authorization scope is `https://www.googleapis.com/auth/display-video`. A `NOT_FOUND` error is returned if the insertion order is not found.\n"],null,["# Method: advertisers.insertionOrders.delete\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes an insertion order. Returns error code `NOT_FOUND` if the insertion order does not exist. The insertion order should be archived first, i.e. set [entityStatus](/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder.FIELDS.entity_status) to `ENTITY_STATUS_ARCHIVED`, to be able to delete it.\n\n### HTTP request\n\n`DELETE https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser this insertion order belongs to. |\n| `insertionOrderId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the insertion order to delete. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
