> ## 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. # /2025-10/marketing-solutions/audience-segments > Updates the properties of all segments with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned. ## OpenAPI ````yaml https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json patch /2025-10/marketing-solutions/audience-segments openapi: 3.0.1 info: title: Criteo API description: Criteo API - MarketingSolutions version: 2025-10 servers: - url: https://api.criteo.com security: - oauth: [] tags: - name: Advertiser - name: Analytics - name: Audience - name: Campaign - name: Creative - name: Gateway - name: Reco paths: /2025-10/marketing-solutions/audience-segments: patch: tags: - Audience summary: /2025-10/marketing-solutions/audience-segments description: >- Updates the properties of all segments with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned. operationId: UpdateAudienceSegments requestBody: description: Segment Update request content: application/json: schema: $ref: '#/components/schemas/AudienceSegmentBulkUpdateInputV1' required: true x-bodyName: request responses: '200': description: Success or partial success content: application/json: schema: $ref: '#/components/schemas/AudienceSegmentEntityV1ListResponse' security: - oauth: - MarketingSolutions_Audience_Manage components: schemas: AudienceSegmentBulkUpdateInputV1: type: object properties: data: type: array items: $ref: '#/components/schemas/AudienceSegmentUpdateEntityV1Resource' description: Input to update one or more segments. AudienceSegmentEntityV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/AudienceSegmentEntityV1Resource' 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 AudienceSegmentUpdateEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/AudienceSegmentUpdateEntityV1' id: type: string description: Id of the entity type: type: string description: A class that represents a domain entity exposed by an API AudienceSegmentEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/AudienceSegmentEntityV1' 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. AudienceSegmentUpdateEntityV1: type: object properties: description: $ref: '#/components/schemas/NillableString' inMarket: $ref: '#/components/schemas/InMarketUpdateV1' location: $ref: '#/components/schemas/LocationUpdateV1' lookalike: $ref: '#/components/schemas/LookalikeUpdateV1' name: type: string description: Name of the segment prospecting: $ref: '#/components/schemas/ProspectingUpdateV1' retargeting: $ref: '#/components/schemas/RetargetingUpdateV1' description: Set of rules that defines specific people to target. x-criteo-canonical: infoType: entity name: AudienceSegment version: v1 AudienceSegmentEntityV1: type: object properties: advertiserId: type: string description: Advertiser associated to the segment nullable: true behavioral: $ref: '#/components/schemas/BehavioralV1' contactList: $ref: '#/components/schemas/ContactListV1' createdAt: type: string description: ISO-8601 timestamp in UTC of segment creation (read-only) format: date-time nullable: true description: type: string description: Description of the segment nullable: true inMarket: $ref: '#/components/schemas/InMarketV1' location: $ref: '#/components/schemas/LocationV1' lookalike: $ref: '#/components/schemas/LookalikeV1' name: type: string description: Name of the segment nullable: true prospecting: $ref: '#/components/schemas/ProspectingV1' retargeting: $ref: '#/components/schemas/RetargetingV1' type: enum: - Unknown - InMarket - Prospecting - ContactList - Location - Behavioral - Retargeting - Lookalike 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: AudienceSegment version: v1 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 InMarketUpdateV1: type: object properties: brandIds: uniqueItems: true type: array items: type: string description: Choose the brands your segment might be interested in buyingPower: uniqueItems: true type: array items: enum: - Low - Medium - High - VeryHigh type: string description: >- Reach people who frequently purchase high price range items to lower price range items country: type: string description: Reach people of a specific country gender: $ref: '#/components/schemas/NillableGenderV1' interestIds: uniqueItems: true type: array items: type: string description: Reach new people based on their interests priceRange: uniqueItems: true type: array items: enum: - Low - Medium - High type: string description: >- Reach people who’ve shown interest in products within a specific price range description: >- Settings to target users based on high shopping intents and demographics. LocationUpdateV1: type: object properties: pointsOfInterest: type: array items: $ref: '#/components/schemas/PointOfInterestV1' description: >- Reach users which have been historically located in the given coordinates radiusInKm: type: integer description: Radius in kilometers format: int32 registryType: enum: - PointOfInterest type: string description: The kind of Location audience description: Settings to target users based on their location. LookalikeUpdateV1: type: object properties: targetSize: type: integer description: Desired size of the generated Lookalike segment format: int64 description: Settings to target users that behave like a given seed segment ProspectingUpdateV1: type: object properties: daysSinceLastVisitMax: $ref: '#/components/schemas/NillableInt32' daysSinceLastVisitMin: $ref: '#/components/schemas/NillableInt32' usersType: enum: - Prospects - ProspectsOrNonBuyers type: string description: Type of users to target description: Settings to target prospecting users to website visitors. RetargetingUpdateV1: type: object properties: daysSinceLastVisitMax: type: integer description: Maximum number of days since last visit to partner. format: int32 daysSinceLastVisitMin: type: integer description: Minimum number of days since last visit to partner. format: int32 visitorsType: enum: - All - Buyers - NonBuyers type: string description: Types of visitors. description: Settings to target users based on its type and days since last visit. BehavioralV1: required: - category type: object properties: category: enum: - Unknown - Lifestyles - LifeEvents - Seasonal - BuyingPatterns type: string description: The type of behavioral country: type: string description: The users' country nullable: true endDate: type: string description: Desired date when the behavioral will end format: date-time nullable: true startDate: type: string description: Desired date when the behavioral will start format: date-time nullable: true description: Settings of a behavioral set of users provided by Criteo. nullable: true ContactListV1: type: object properties: isReadOnly: type: boolean description: Is the segment read-only nullable: true description: Settings to target users with your contact lists. nullable: true InMarketV1: type: object properties: brandIds: uniqueItems: true type: array items: type: string description: Choose the brands your segment might be interested in nullable: true buyingPower: uniqueItems: true type: array items: enum: - Unknown - Low - Medium - High - VeryHigh type: string description: >- Reach people who frequently purchase high price range items to lower price range items nullable: true country: type: string description: Reach people of a specific country nullable: true gender: enum: - Unknown - Male - Female type: string description: >- Reach people who’ve shown interest in products made for a specific gender nullable: true interestIds: uniqueItems: true type: array items: type: string description: Reach new people based on their interests nullable: true priceRange: uniqueItems: true type: array items: enum: - Unknown - Low - Medium - High type: string description: >- Reach people who’ve shown interest in products within a specific price range nullable: true description: >- Settings to target users based on high shopping intents and demographics. nullable: true LocationV1: type: object properties: pointsOfInterest: type: array items: $ref: '#/components/schemas/PointOfInterestV1' description: >- Reach users which have been historically located in the given coordinates nullable: true radiusInKm: type: integer description: >- The expected maximum distance in kilometers between a user and a point of interest format: int32 nullable: true registryType: enum: - Unknown - PointOfInterest type: string description: The kind of Location audience nullable: true description: Settings to target users based on their location. nullable: true LookalikeV1: type: object properties: seedSegmentId: type: string description: Segment from which the Lookalike segment will be generated nullable: true targetSize: type: integer description: Desired size of the generated Lookalike segment format: int64 nullable: true description: Settings to target users that behave like a given seed segment nullable: true ProspectingV1: type: object properties: daysSinceLastVisitMax: type: integer description: >- When non buyers are included, include users who visited your website after this number of days format: int32 nullable: true daysSinceLastVisitMin: type: integer description: >- When non buyers are included, include users who visited your website before this number of days format: int32 nullable: true usersType: enum: - Unknown - Prospects - ProspectsOrNonBuyers type: string description: Type of users to target nullable: true description: Settings to target prospecting users to website visitors. nullable: true RetargetingV1: type: object properties: daysSinceLastVisitMax: type: integer description: Maximum number of days since last visit to partner. format: int32 nullable: true daysSinceLastVisitMin: type: integer description: Minimum number of days since last visit to partner. format: int32 nullable: true visitorsType: enum: - Unknown - All - Buyers - NonBuyers type: string description: Types of visitors. nullable: true description: Settings to target users based on its type and days since last visit. nullable: true NillableGenderV1: type: object properties: value: enum: - Male - Female type: string description: The value. If missing or null the value is set to "null" nullable: true description: Placeholder object for value for which "null" is a valid business value nullable: true PointOfInterestV1: type: object properties: latitude: type: number description: ISO-6709 latitude (rounded at 5 decimals) format: double nullable: true longitude: type: number description: ISO-6709 longitude (rounded at 5 decimals) format: double nullable: true name: type: string description: Name of the point of interest nullable: true description: "Named coordinate defined by its latitude and longitude.\r\nLatitude and Longitude are rounded at 5 decimals." NillableInt32: type: object properties: value: type: integer description: The value. If missing or null the value is set to "null" format: int32 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: {} ````