Skip to content

Update Insertion Orders

Request

Update up to 100 insertion orders in a single request. Specify only the properties you want to update. Properties you omit remain unchanged.

This endpoint is transactional. If the request succeeds, all insertion orders are updated. If the request fails, no insertion orders are updated.

Security
SessionCookie
Bodyapplication/jsonrequired
insertion_ordersArray of objects(api.dsp.v1.UpdateInsertionOrderRequest)
curl -i -X PATCH \
  https://platform-api.vistarmedia.com/api/dsp/v1/insertion_orders \
  -H 'Content-Type: application/json' \
  -H 'Cookie: YOUR_API_KEY_HERE' \
  -d '{
    "insertion_orders": [
      {
        "id": "juIGaOygS0CBBqtmXHamqA",
        "contract_number": "C-102930",
        "name": "My Insertion Order Name",
        "start_time": "2004-09-22T16:16:42Z",
        "end_time": "2004-09-22T17:16:42Z",
        "budget_impressions": "10000",
        "budget_money": {
          "currency_code": "USD",
          "units": "1",
          "nanos": 750000000
        }
      }
    ]
  }'

Responses

A successful response.

Bodyapplication/json
insertion_ordersArray of objects(api.dsp.v1.InsertionOrder)
Response
{ "insertion_orders": [ { … } ] }