--- title: "Update segment criteria" slug: "update-segment-criteria" abstract: "Describes the request and response details of this Sitecore Send API endpoint to update the criteria or rules in a specific segment." --- # Update segment criteria `POST /lists/{MailingListID}/segments/{SegmentID}/criteria/{CriteriaID}/update.{Format}` Updates an existing criterion or rule in a specific segment in your email list. ## Request | Parameter | In | Type | Required | Description | | --- | --- | --- | --- | --- | | Accept | header | string | true | Determines the expected format and data type to retrieve the response data.Value: application/json | | MailingListID | path | string | true | The ID of the email list that contains the segment. | | SegmentID | path | string | true | The ID of the segment. | | CriteriaID | path | number(double) | true | The ID of the criteria of a segment to be updated. | | Format | path | string | true | The supported file format for getting a response.Possible values: json and xml. | | apikey | query | string | true | The API key of your account. | | Field | body | string | true | The criterion used to filter the email list. See Field values. | | Comparer | body | string | false | The operator that defines how to compare a Field with its Value. See Comparer values. | | Value | body | string | false | The search term used to filter the specified Field. | | LastXMinutes | body | integer | false | Constrains the results by the time that has elapsed. | | DateFrom to DateTo | body | date | false | Constrains the results by a date span. | | DateFunction | body | string | false | The value used with custom fields of dateTime data type. See DateFunction values. | ### Field values Select one of the following `Field` values to filter the email list: - `DateAdded` - filters subscribers by the date they were added to the email list. - `DateUpdated` - filters subscribers by the date they were last updated in the email list. - `RecipientName` - filters subscribers by name. - `RecipientEmail` - filters subscribers by their email address. - `SubscribeMethod` - filters subscribers by their subscription method. - `CustomField` - filters subscribers by the value of a custom field. - `MailingListIncluded` - filters subscribers by checking if they belong to another mailing list. - `CampaignsOpened` - filters subscribers by the number of campaigns they have opened within the past 60 days. - `LinksClicked` - filters subscribers by the number of links they have clicked from the campaigns sent to them within the past 60 days. - `CampaignName` - filters subscribers by the name of the campaign they have opened. - `LinkURL` - filters subscribers by the URL of the link they have clicked. - `CampaignSent` - filters subscribers by the campaign they have received or not received. - `Platform` - filters subscribers by the platform they use. - `OperatingSystems` - filters subscribers by the operating system they use. - `EmailClient` - filters subscribers by the email client they use. - `WebBrowser` - filters subscribers by the web browser they use. - `MobileBrowser` - filters subscribers by the mobile browser they use. - `AddedAnythingToCart` - filters subscribers by their cart history in a tracked website. - `ViewedProduct` - filters subscribers by their browsing history in a tracked website. - `PurchasedProduct` - filters subscribers by their purchase history in a tracked website. - `ViewedProductCategory` - filters subscribers by their browsing history in a tracked website. - `PurchasedProductCategory` - filters subscribers by their purchase history in a tracked website. - `ViewedProductBrand` - filters subscribers by their browsing history in a tracked website. - `PurchasedProductBrand` - filters subscribers by their purchase history in a tracked website. - `Preference` - filters subscribers by their preferences. ### Comparer values Select one of the following `Comparer` operators to compare a criterion field with its value: - `Is` - finds subscribers where the `Field` is exactly equal to the specified `Value`. - `IsNot` - finds subscribers where the `Field` is not equal to the specified `Value` - `Contains` - finds subscribers where the `Field` contains the specified `Value`. - `DoesNotContain` - finds subscribers where the `Field` does not contain the specified `Value`. - `StartsWith` - finds subscribers where the `Field` starts with the specified `Value`. - `DoesNotStartWith` - finds subscribers where the `Field` does not start with the specified `Value`. - `EndsWith` - finds subscribers where the `Field` ends with the specified `Value`. - `DoesNotEndWith` - finds subscribers where the `Field` does not end with the specified `Value`. - `IsGreaterThan` - finds subscribers where the `Field` is greater than the specified `Value`. - `IsGreaterThanOrEqualTo` - finds subscribers where the `Field` is greater than or equal to the specified `Value`. - `IsLessThan` - finds subscribers where the `Field` is less than the specified `Value`. - `IsLessThanOrEqualTo` - finds subscribers where the `Field` is less than or equal to the specified `Value`. - `IsBefore` - finds subscribers where the `Field` is before the specified `Value`. - `IsAfter` - finds subscribers where the `Field` is after the specified `Value`. - `IsEmpty` - finds subscribers where the `Field` has no `Value`. - `IsNotEmpty` - finds subscribers where the `Field` contains a `Value`. - `IsTrue` - finds subscribers where the condition defined by the `Field` is true. - `IsFalse` - finds subscribers where the condition defined by the `Field` is false. ### DateFunction values Select one of the following to use with fields of `DateTime` data type. - `Year` - the four-digit year part of the date. - `Month` - the month part of the date from `1` to `12`. - `Day` - the day part of the date from `1` to `31`. - `WeekDay` - the day of the week from `1` to `7`. For example, `1` for Sunday, `2` for Monday, and so on. - `DaysPassed` - the number of days that have passed until now. - `HoursPassed` - the number of hours that have passed until now. - `MinutesPassed` - the number of minutes that have passed until now. ```http POST https://{hostname}/v3/lists/{MailingListID}/segments/{SegmentID}/criteria/{CriteriaID}/update.{Format}?apikey= Request body: { "Field": "LinkURL", "Comparer": "is", "Value": "https://www.yourpage.com/" } ``` ```curl curl --include \\ --request POST \\ --header "Content-Type: application/json" \\ --header "Accept: application/json" \\ --data-raw '{ "Field": "LinkURL", "Comparer": "is", "Value": "https://www.yourpage.com/" }' \\ 'https://{hostname}/v3/lists/{MailingListID}/segments/{SegmentID}/criteria/{CriteriaID}/update.{Format}?apikey=' ``` ## Response | Status | Description | Headers | Schema | | --- | --- | --- | --- | | 200 OK | The request is successful. | Content-Type:application/jsonAccept:application/json | N/A | ```json { "Code": 0, "Error": null, "Context": 15783 } ``` - `Code` - the response code. This is `0` if successful. - `Error` - the response error message. This is `null` if successful. - `Context` - the ID of the updated segment.