/2026-01/retail-media/auction-line-items/{lineItemId}

cURL

curl --request PUT \
  --url https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "type": "<string>"
  }
}
'

import requests

url = "https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}"

payload = { "data": { "type": "<string>" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({data: {type: '<string>'}})
};

fetch('https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'type' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
    "fmt"
    "strings"
    "net/http"
    "io"
)

func main() {

url := "https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}"

payload := strings.NewReader("{\n  \"data\": {\n    \"type\": \"<string>\"\n  }\n}")

req, _ := http.NewRequest("PUT", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
    req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"type\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.criteo.com/2026-01/retail-media/auction-line-items/{lineItemId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"type\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

200

{
  "data": {
    "attributes": {
      "budgetRemaining": 123,
      "campaignId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "startDate": "2023-11-07T05:31:56Z",
      "targetRetailerId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "budget": 123,
      "budgetSpent": 123,
      "dailyPacing": 123,
      "endDate": "2023-11-07T05:31:56Z",
      "flightSchedule": {
        "legs": [
          {
            "endTime": "<string>",
            "startTime": "<string>"
          }
        ]
      },
      "isAutoDailyPacing": true,
      "maxBid": 123,
      "monthlyPacing": 123,
      "targetBid": 123
    },
    "id": "<string>",
    "type": "<string>"
  },
  "errors": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>"
    }
  ],
  "warnings": [
    {
      "code": "<string>",
      "detail": "<string>",
      "instance": "<string>",
      "source": {},
      "stackTrace": "<string>",
      "title": "<string>",
      "traceId": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

lineItemId

string

required

The external line item ID of the sponsored products line item.

Body

application/json

An update request containing all details of the requested update.

A top-level object that encapsulates a Criteo API request for a single value object.

Response

200 - application/json

Success

A top-level object that encapsulates a Criteo API response for a single entity.