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

# Version 2022.10 Release Notes

Version 2022.10 of the Criteo retail media API is live as of October 25th and will be supported until October 31st, 2023. A new version of the [**Criteo SDK libraries**](/retail-media/v2022.10/docs/api-client-libraries) and [**Postman**](/retail-media/v2022.10/docs/use-postman-with-the-criteo-retail-media-api)collection is also now available for 2022.10.

# What's New

In this new release, we introduce a series of new endpoints for **preferred deals campaign types only**. For a copy of these documents, please reach out to your account representative.

## Category Search

Product categories allow retailers to create a hierarchal structure that helps narrow down products into unique groups or sub-groups based on shared characteristics.

With the API you can now easily search for a retailer product based on a particular category name, or categories belonging to a retailer.

<table>
  <thead>
    <tr>
      <th />

      <th />

      <th />
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Category by Category ID
          </b>
        </p>
      </td>

      <td>
        <p>
          *Search for categories based on category ID*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Categories by Retailer
          </b>
        </p>
      </td>

      <td>
        <p>
          *Search for retailer categories and filter down by a specific category name*
        </p>
      </td>
    </tr>
  </tbody>
</table>

## Creatives for Commerce Display

In v2022.10 we are also introducing a set of new API endpoints that allows building commerce display creatives completely through the API. With the new endpoints you will be able to:

✔️ Upload creative image assets\
✔️ View available retailer creative templates\
✔️ Build new creatives using either one of our built-in templates or using a custom template\
✔️ Associate the product SKUs you wish to display on each creative

### Step 1 - Creative Asset Uploads

Upload creatives asset files using a new POST call:

<table>
  <thead>
    <tr>
      <th />

      <th />

      <th />
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <b>
            POST
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Upload Image Asset
          </b>
        </p>
      </td>

      <td>
        <p>
          *Upload creative asset image file*
        </p>
      </td>
    </tr>
  </tbody>
</table>

### Step 2 - Creative Builder

Construct new creative assets for preferred deals line items. Here we introduced four new endpoints:

<table>
  <thead>
    <tr>
      <th />

      <th />

      <th />
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Retailer Templates
          </b>
        </p>
      </td>

      <td>
        <p>
          *Get a list of available creative templates for a specified retailer*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            POST
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Create Creative
          </b>
        </p>
      </td>

      <td>
        <p>
          *Create a new account creative*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Get Creative by Creative ID
          </b>
        </p>
      </td>

      <td>
        <p>
          *Get account creative by creative id*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            PUT
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Update an Existing Creative
          </b>
        </p>
      </td>

      <td>
        <p>
          *Update an existing creative*
        </p>
      </td>
    </tr>
  </tbody>
</table>

### Step 3 - Creative Product SKU Collection

Launching commerce onsite display creatives requires associating product SKUs with the creative before activating a line item. To support this functionality we introduce the following new endpoints:

<table>
  <thead>
    <tr>
      <th />

      <th />

      <th />
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Get Product SKUs by Line-Item-Id
          </b>
        </p>
      </td>

      <td>
        <p>
          *Get a single Product SKU collection (product button)*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            GET
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Get Product SKUs by Line Item Id and Product SKU Collection Id
          </b>
        </p>
      </td>

      <td>
        <p>
          *Get all the Product SKU collection (product buttons) associated with a line item*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            POST
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Create Product SKU Collection to Line Item
          </b>
        </p>
      </td>

      <td>
        <p>
          *Create a new Product SKU collection (product buttons) on a line item*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            PUT
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Update Line Item Product SKU Collection
          </b>
        </p>
      </td>

      <td>
        <p>
          *Update a Product SKU collection (product button)*
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            DELETE
          </b>
        </p>
      </td>

      <td>
        <p>
          <b>
            Delete Product SKU Collection from a Line Item Id
          </b>
        </p>
      </td>

      <td>
        <p>
          *Delete a Product SKU collection (Product Button)*
        </p>
      </td>
    </tr>
  </tbody>
</table>