> ## 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. # /2026-01/retail-media/accounts/{account-id}/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. ## OpenAPI ````yaml https://api.criteo.com/2026-01/retailmedia/open-api-specifications.json patch /2026-01/retail-media/accounts/{account-id}/audience-segments openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: 2026-01 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Billing - name: Campaign - name: Gateway paths: /2026-01/retail-media/accounts/{account-id}/audience-segments: patch: tags: - Audience summary: /2026-01/retail-media/accounts/{account-id}/audience-segments description: >- 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. operationId: bulkUpdateAudienceSegments parameters: - name: account-id in: path description: Account id required: true schema: type: string requestBody: description: Segment Update request content: application/json: schema: $ref: '#/components/schemas/RmAudienceSegmentBulkUpdateInputV1' required: true x-bodyName: request responses: '200': description: Success or partial success content: application/json: schema: $ref: '#/components/schemas/RmAudienceSegmentEntityV1ListResponse' security: - oauth: - RetailMedia_Audience_Manage components: schemas: RmAudienceSegmentBulkUpdateInputV1: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentUpdateEntityV1Resource' description: >- A top-level object that encapsulates a Criteo API request for several entities. RmAudienceSegmentEntityV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: >- A top-level object that encapsulates a Criteo API response for several entities RmAudienceSegmentUpdateEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentUpdateEntityV1' id: type: string description: Id of the entity type: type: string description: A class that represents a domain entity exposed by an API RmAudienceSegmentEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: >- A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: >- The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. RmAudienceSegmentUpdateEntityV1: type: object properties: contactList: $ref: '#/components/schemas/RmContactListUpdateV1' description: $ref: '#/components/schemas/NillableString' events: $ref: '#/components/schemas/RmEventsUpdateV1' name: type: string description: Name of the segment description: Set of rules that defines specific people to target. x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmAudienceSegmentEntityV1: type: object properties: accountId: type: string description: Account associated to the segment nullable: true channels: type: array items: enum: - Unknown - Onsite - Offsite type: string description: Channels associated to the segment (read-only) nullable: true contactList: $ref: '#/components/schemas/RmContactListV1' createdAt: type: string description: ISO-8601 timestamp in UTC of segment creation (read-only) format: date-time nullable: true createdById: type: string description: User that created the segment nullable: true description: type: string description: Description of the segment nullable: true events: $ref: '#/components/schemas/RmEventsV1' name: type: string description: Name of the segment nullable: true retailerId: type: string description: Retailer associated to the segment nullable: true type: enum: - Unknown - ContactList - Events type: string description: Type of segment (read-only) nullable: true updatedAt: type: string description: ISO-8601 timestamp in UTC of segment update (read-only) format: date-time nullable: true description: Set of rules that defines specific people to target. nullable: true x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmContactListUpdateV1: type: object description: Settings to update the contact list of the segment NillableString: type: object properties: value: type: string description: >- The string's value. If missing or null the string's value is set to "null" nullable: true description: >- Placeholder object for string value for which "null" is a valid business value nullable: true RmEventsUpdateV1: type: object properties: brandIds: type: array items: type: string description: Choose the brands your segment might be interested in categoryIds: type: array items: type: string description: Choose the categories your segment might be interested in lookbackDays: enum: - Last7Days - Last14Days - Last30Days - Last45Days - Last60Days - Last90Days - Last120Days - Last150Days - Last180Days type: string description: Number of days of the lookback windows maxPrice: $ref: '#/components/schemas/NillableDecimal' minPrice: $ref: '#/components/schemas/NillableDecimal' shopperActivity: enum: - View - Buy - AddToCart type: string description: Types of shopper activity. description: Settings to target users based on their behavior RmContactListV1: type: object properties: identifierType: enum: - Unknown - Email - UserIdentifier - IdentityLink - CustomerId - PhoneNumber type: string description: Indicates contact list identifier's type nullable: true isReadOnly: type: boolean description: Is the segment read-only nullable: true sharingStatus: enum: - Unknown - NotShared - SharedWithAll - SharedWithDemandAccounts type: string description: Indicates if the contact list is shared with other accounts nullable: true description: Settings to target users with your contact lists. nullable: true RmEventsV1: type: object properties: brandIds: type: array items: type: string description: The list of brand ids nullable: true categoryIds: type: array items: type: string description: The list of category ids nullable: true lookbackDays: enum: - Unknown - Last7Days - Last14Days - Last30Days - Last45Days - Last60Days - Last90Days - Last120Days - Last150Days - Last180Days type: string description: The number of days to look back nullable: true maxPrice: type: number description: Maximum price of the products format: double nullable: true minPrice: type: number description: Minimum price of the products format: double nullable: true shopperActivity: enum: - Unknown - View - Buy - AddToCart type: string description: Reach people who performed specific action nullable: true description: Settings to target users based on their behavior nullable: true NillableDecimal: type: object properties: value: type: number description: The value. If missing or null the value is set to "null" format: double nullable: true description: Placeholder object for value for which "null" is a valid business value nullable: true securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} ````