---
title: "/2026-01/commerce-grid/audience-segments"
method: PATCH
path: "/2026-01/commerce-grid/audience-segments"
tags: ["Segment"]
---

# /2026-01/commerce-grid/audience-segments

`PATCH /2026-01/commerce-grid/audience-segments`

Updates the properties of all segments with a valid configuration, and returns the full segments. For those that cannot be updated, one or multiple errors are returned.

## Request body

- CgAudienceSegmentBulkUpdateInputV1 — A top-level object that encapsulates a Criteo API request for several entities.
  - `data` CgAudienceSegmentUpdateEntityV1Resource[]
    - `attributes` CgAudienceSegmentUpdateEntityV1 — Set of rules that defines specific people to target.
      - `description` NillableString, nullable — Placeholder object for string value for which "null" is a valid business value
        - `value` string, nullable — The string's value. If missing or null the string's value is set to "null"
      - `name` string — Name of the segment
    - `id` string — Id of the entity
    - `type` string

## Response `200`

Success or partial success

- CgAudienceSegmentEntityV1ListResponse — A top-level object that encapsulates a Criteo API response for several entities
  - `data` CgAudienceSegmentEntityV1Resource[], nullable
    - `attributes` CgAudienceSegmentEntityV1, nullable — Set of rules that defines specific people to target.
      - `contactList` CgContactListV1, nullable — Settings to target users with your contact lists.
      - `createdAt` string, date-time, nullable — ISO-8601 timestamp in UTC of segment creation (read-only)
      - `dataProviderId` string, nullable — Data provider associated to the segment (read-only)
      - `description` string, nullable — Description of the segment
      - `name` string, nullable — Name of the segment
      - `remoteId` string, nullable — The ID used to identify the segment in the data provider's system (read-only)
      - `type` 'Unknown' | 'ContactList', nullable — Type of segment (read-only)
      - `updatedAt` string, date-time, nullable — ISO-8601 timestamp in UTC of segment update (read-only)
    - `id` string, nullable — Id of the entity
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `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[], nullable
    - `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)