> ## 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 2021.10 release notes

## What’s new?

Version 2021.10 of the Criteo API is live as of January 5th, 2022. This version will be supported until January 4th, 2023.

This version introduces several new capabilities to Criteo Retail Media API and introduces changes in previously existing endpoints.

This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.

## New Base url

We are moving from:

* `https://api.criteo.com/2021-07/retail-media/{endpoint}`\
  to
* `https://api.criteo.com/2021-10/retail-media/{endpoint}`

## Addition / removal of items

Using PUT and DELETE methods to add or remove items is deprecated. Instead, dedicated `/append` and `/delete` endpoints have been added, that can be called using POST method

## Reporting

It is now possible to request a report for multiple campaigns or line items at once. To do so, the id parameter much be replaced by ids and its value be an array of the campaign or line items to report on.\
Modified endpoints are

* `/2021-10/retail-media/reports/campaigns`
* `/2021-10/retail-media/reports/line-items`

## Catalog filtering

It is now possible to restrict catalog request to particular brand(s), by indicating them in the `brandIdFilter` .\
Affected endpoints is `/2021-10/retail-media/accounts/{accountId}/catalogs`\
No other change was made to the request nor response.

<Check>
  **Access to Preferred Deals capabilities**

  Our Preferred Deals capabilities are currently only accessible to our Retailer partners as part of our beta launch.\
  To gain access to Preferred Deals documentation, please reach out to your Criteo Account Manager.
</Check>