---
title: "/2026-01/retail-media/preferred-line-items/{line-item-id}"
method: PUT
path: "/2026-01/retail-media/preferred-line-items/{line-item-id}"
tags: ["Campaign"]
---

# /2026-01/retail-media/preferred-line-items/{line-item-id}

`PUT /2026-01/retail-media/preferred-line-items/{line-item-id}`

Updates the preferred line item for the given line item id

## Path parameters

- `line-item-id` string, required

## Request body

- PreferredLineItemUpdateModelV2Request — A top-level object that encapsulates a Criteo API request for a single entity
  - `data` ResourceOfPreferredLineItemUpdateModelV2 — A class that represents a domain entity exposed by an API
    - `attributes` PreferredLineItemUpdateModelV2 — Model used to update a preferred line item
      - `budget` number, double
      - `capping` LineItemCappingV2, nullable — Frequency Capping for a Preferred Line Item
        - `count` integer, required
        - `type` 'unknown' | 'day' | 'session', required — Line Item Capping Type Enum
      - `creativeId` string, long-id
      - `endDate` string, date, required — Represents the Date as a year, month, and day in the format YYYY-MM-DD
      - `name` string, required
      - `pacing` 'unknown' | 'standard' | 'accelerated'
      - `page` LineItemPageV2, nullable — Page information for a preferred line item
        - `categories` LineItemPageCategoryV2[], nullable
          - `categoryId` string, required
          - `includeChildren` boolean
        - `pageType` 'unknown' | 'search' | 'home' | 'browse' | 'checkout' | 'category' | 'productDetail' | 'confirmation' | 'merchandising' | 'deals' | 'favorites' | 'searchBar' | 'categoryMenu', required — Page Type Enum
        - `searchKeywords` string[], nullable
      - `startDate` string, date, required — Represents the Date as a year, month, and day in the format YYYY-MM-DD
      - `status` 'unknown' | 'active' | 'scheduled' | 'draft' | 'paused' | 'budgetHit' | 'ended' | 'archived' | 'noFunds', required — Line Item Status Enum
    - `id` string — Id of the entity
    - `type` string — Canonical type name of the entity

## Response `200`

Success

- PreferredLineItemV2Response — A top-level object that encapsulates a Criteo API response for a single entity
  - `data` ResourceOfPreferredLineItemV2, nullable — A class that represents a domain entity exposed by an API
    - `attributes` PreferredLineItemV2 — A Retail Media Preferred Line Item used to hold bid settings for one or many promoted products on a single retailer
      - `budget` number, double, required
      - `budgetRemaining` number, double, nullable
      - `budgetSpent` number, double, nullable
      - `campaignId` string, long-id, required
      - `capping` LineItemCappingV2, nullable — Frequency Capping for a Preferred Line Item
        - `count` integer, required
        - `type` 'unknown' | 'day' | 'session', required — Line Item Capping Type Enum
      - `createdAt` string, date-time
      - `creativeId` string, long-id, nullable — creative Id
      - `endDate` string, date, nullable — Represents the Date as a year, month, and day in the format YYYY-MM-DD
      - `id` string, nullable
      - `name` string, required
      - `pacing` 'unknown' | 'standard' | 'accelerated', nullable
      - `page` LineItemPageV2, nullable — Page information for a preferred line item
        - `categories` LineItemPageCategoryV2[], nullable
          - `categoryId` string, required
          - `includeChildren` boolean
        - `pageType` 'unknown' | 'search' | 'home' | 'browse' | 'checkout' | 'category' | 'productDetail' | 'confirmation' | 'merchandising' | 'deals' | 'favorites' | 'searchBar' | 'categoryMenu', required — Page Type Enum
        - `searchKeywords` string[], nullable
      - `startDate` string, date, required — Represents the Date as a year, month, and day in the format YYYY-MM-DD
      - `status` 'unknown' | 'active' | 'scheduled' | 'draft' | 'paused' | 'budgetHit' | 'ended' | 'archived' | 'noFunds', required — Line Item Status Enum
      - `targetRetailerId` string, long-id, required
      - `updatedAt` string, date-time
    - `id` string, nullable — Id of the entity
    - `type` string, nullable — Canonical type name of the entity
  - `errors` CommonProblem[]
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` CommonProblem[]
    - `code` string, nullable — A machine-readable error code, expressed as a string value.
    - `detail` string, nullable — A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable — A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable — A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable — The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)