bulk Update Audience Segments

PATCH {{baseUrl}}/2023-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.

Request Body

{"data"=>[{"attributes"=>{"name"=>"<string>", "description"=>{"value"=>"<string>"}, "inMarket"=>{"country"=>"<string>", "buyingPower"=>["Low", "Low"], "gender"=>{"value"=>"Female"}, "interestIds"=>["<string>", "<string>"], "brandIds"=>["<string>", "<string>"], "priceRange"=>["Low", "High"]}, "location"=>{"pointsOfInterest"=>[{"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}, {"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}], "radiusInKm"=>"<integer>", "registryType"=>"PointOfInterest"}, "retargeting"=>{"visitorsType"=>"All", "daysSinceLastVisitMin"=>"<integer>", "daysSinceLastVisitMax"=>"<integer>"}, "lookalike"=>{"targetSize"=>"<long>"}, "prospecting"=>{"daysSinceLastVisitMin"=>{"value"=>"<integer>"}, "daysSinceLastVisitMax"=>{"value"=>"<integer>"}, "usersType"=>"ProspectsOrNonBuyers"}}, "id"=>"<string>", "type"=>"<string>"}, {"attributes"=>{"name"=>"<string>", "description"=>{"value"=>"<string>"}, "inMarket"=>{"country"=>"<string>", "buyingPower"=>["Medium", "Medium"], "gender"=>{"value"=>"Male"}, "interestIds"=>["<string>", "<string>"], "brandIds"=>["<string>", "<string>"], "priceRange"=>["Low", "Low"]}, "location"=>{"pointsOfInterest"=>[{"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}, {"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}], "radiusInKm"=>"<integer>", "registryType"=>"PointOfInterest"}, "retargeting"=>{"visitorsType"=>"All", "daysSinceLastVisitMin"=>"<integer>", "daysSinceLastVisitMax"=>"<integer>"}, "lookalike"=>{"targetSize"=>"<long>"}, "prospecting"=>{"daysSinceLastVisitMin"=>{"value"=>"<integer>"}, "daysSinceLastVisitMax"=>{"value"=>"<integer>"}, "usersType"=>"ProspectsOrNonBuyers"}}, "id"=>"<string>", "type"=>"<string>"}]}

HEADERS

RESPONSES

status: OK

{"data":[{"attributes":{"name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"Lookalike","createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","advertiserId":"\u003cstring\u003e","inMarket":{"country":"\u003cstring\u003e","buyingPower":["Medium","Unknown"],"gender":"Male","interestIds":["\u003cstring\u003e","\u003cstring\u003e"],"brandIds":["\u003cstring\u003e","\u003cstring\u003e"],"priceRange":["Low","Low"]},"prospecting":{"daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e","usersType":"ProspectsOrNonBuyers"},"contactList":{"isReadOnly":"\u003cboolean\u003e"},"location":{"pointsOfInterest":[{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"},{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"}],"radiusInKm":"\u003cinteger\u003e","registryType":"PointOfInterest"},"behavioral":{"category":"Lifestyles","country":"\u003cstring\u003e","startDate":"\u003cdateTime\u003e","endDate":"\u003cdateTime\u003e"},"retargeting":{"visitorsType":"Buyers","daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e"},"lookalike":{"seedSegmentId":"\u003cstring\u003e","targetSize":"\u003clong\u003e"}},"id":"\u003cstring\u003e","type":"\u003cstring\u003e"},{"attributes":{"name":"\u003cstring\u003e","description":"\u003cstring\u003e","type":"Lookalike","createdAt":"\u003cdateTime\u003e","updatedAt":"\u003cdateTime\u003e","advertiserId":"\u003cstring\u003e","inMarket":{"country":"\u003cstring\u003e","buyingPower":["Unknown","VeryHigh"],"gender":"Male","interestIds":["\u003cstring\u003e","\u003cstring\u003e"],"brandIds":["\u003cstring\u003e","\u003cstring\u003e"],"priceRange":["High","Unknown"]},"prospecting":{"daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e","usersType":"Prospects"},"contactList":{"isReadOnly":"\u003cboolean\u003e"},"location":{"pointsOfInterest":[{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"},{"name":"\u003cstring\u003e","latitude":"\u003cdouble\u003e","longitude":"\u003cdouble\u003e"}],"radiusInKm":"\u003cinteger\u003e","registryType":"PointOfInterest"},"behavioral":{"category":"Lifestyles","country":"\u003cstring\u003e","startDate":"\u003cdateTime\u003e","endDate":"\u003cdateTime\u003e"},"retargeting":{"visitorsType":"NonBuyers","daysSinceLastVisitMin":"\u003cinteger\u003e","daysSinceLastVisitMax":"\u003cinteger\u003e"},"lookalike":{"seedSegmentId":"\u003cstring\u003e","targetSize":"\u003clong\u003e"}},"id":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"warnings":[{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"authentication","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"dolor_1":"\u003cstring\u003e","nisi_e8_":"\u003cstring\u003e","dolor357":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"},{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"authentication","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"ut_d":"\u003cstring\u003e","ad_":"\u003cstring\u003e","aute54_":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"}],"errors":[{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"validation","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"estd":"\u003cstring\u003e","pariatur_e":"\u003cstring\u003e","qui_77":"\u003cstring\u003e","quis_a6_":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"},{"traceId":"\u003cstring\u003e","traceIdentifier":"\u003cstring\u003e","type":"quota","code":"\u003cstring\u003e","instance":"\u003cstring\u003e","title":"\u003cstring\u003e","detail":"\u003cstring\u003e","source":{"eu0dd":"\u003cstring\u003e","proident_d":"\u003cstring\u003e"},"stackTrace":"\u003cstring\u003e"}]}