> ## 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 2026.01 Release Note

<Info>
  Version **`2026.01`** of  Criteo's API is live as of **January 27th, 2026** and will be supported until **February 2nd, 2027**.

  * A **new Postman collection** for `2026.01` is also available in the [Criteo Postman workspace](https://www.postman.com/realcriteo/workspace/criteo/overview).
  * **New SDK versions** are available for the `2026.01` release. You can find them [on this page](/marketing-solutions/docs/api-client-libraries).
</Info>

***

This version introduces new capabilities to the Criteo API and changes to existing endpoints. This page aims at listing all changes that happened endpoint by endpoint. **Only endpoints with changes are listed here.**

The changes in versions `2026.01` are:

* a new **base URL**,
* New **Commerce Grid Audience Segment** endpoints have been introduced.

***

# New Base URL

With the introduction of this new version, the base URL will now change from **the old base URL**:

```text URL theme={null}
https://api.criteo.com/2025-10/{endpoint}
```

to the **new base URL**:

```text URL theme={null}
https://api.criteo.com/2026-01/{endpoint}
```

***

# What's New

## New Commerce Grid Audience Segments Endpoints

Criteo's Commerce Grid Audience Segments API allows you to manage your audience segments by creating, deleting, and updating their data. Audience Segments represent a group of users to target.

The new available endpoints are the following:

<table>
  <thead>
    <tr>
      <th>
        <p>
          Verb
        </p>
      </th>

      <th>
        <p>
          Endpoint
        </p>
      </th>

      <th>
        <p>
          Description
        </p>
      </th>
    </tr>
  </thead>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/create
          </code>
        </p>
      </td>

      <td>
        <p>
          Create a new Audience Segment
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            PATCH
          </b>
        </p>
      </td>

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments
          </code>
        </p>
      </td>

      <td>
        <p>
          Update an Audience Segment
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/delete
          </code>
        </p>
      </td>

      <td>
        <p>
          Delete an Audience Segment
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/search
          </code>
        </p>
      </td>

      <td>
        <p>
          Search for Audience Segments by segment IDs, data provider IDs and/or segment types
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/\{audienceSegmentId}/contact-list/statistics
          </code>
        </p>
      </td>

      <td>
        <p>
          Retrieve contact list statistics
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/\{audienceSegmentId}/contact-list/add-remove
          </code>
        </p>
      </td>

      <td>
        <p>
          Add/remove identifiers in contact list Audience Segment
        </p>
      </td>
    </tr>

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

      <td>
        <p>
          <code>
            /commerce-grid/audience-segments/\{audienceSegmentId}/contact-list/clear
          </code>
        </p>
      </td>

      <td>
        <p>
          Clear all identifiers in contact list Audience Segment
        </p>
      </td>
    </tr>
  </tbody>
</table>

<Info>
  See the full documentation [on this page](/marketing-solutions/docs/commerce-grid-audience-segments-endpoints) and the corresponding API reference section [here](https://developers.criteo.com/marketing-solutions/reference/bulkupdateaudiencesegments).
</Info>

<br />