Update Filter Segment

curl --request PATCH \ --url https://api-{dc}.moengage.com/v3/custom-segments/{id} \ --header 'Authorization: Basic <encoded-value>' \ --header 'Content-Type: application/json' \ --header 'MOE-APPKEY: <moe-appkey>' \ --data ' { "name": "segment_example_name_updated", "included_filters": { "filter_operator": "and", "filters": [ { "filter_type": "user_attributes", "name": "Name", "data_type": "string", "operator": "in", "value": [ "chandan" ], "negate": false, "case_sensitive": false } ] }, "updated_by": "[email protected]" } '

{ "data": { "name": "your segment name", "id": "your segment id", "created_time": "2022-12-20T06:21:44.112000", "updated_time": "2022-12-20T06:21:44.160000", "type": "ELASTIC_SEARCH", "source": "API", "description": "Subscription Status 19Dec_7 is active (case insensitive) AND Has executed Email Sent atleast 1 time in-between Feb 15, 2023 and Feb 24, 2023", "included_filters": { "filter_operator": "and", "filters": [ { "filter_type": "user_attributes", "name": "Subscription Status 19Dec_7", "data_type": "string", "operator": "in", "value": [ "active" ], "negate": false, "case_sensitive": false }, { "filter_type": "actions", "attributes": { "filter_operator": "and", "filters": [] }, "executed": true, "primary_time_range": { "type": "between", "value": "2023-02-15T00:00:00.000Z", "value1": "2023-02-24T23:59:59.999Z", "value_type": "absolute", "period_unit": "days" }, "action_name": "MOE_EMAIL_SENT", "execution": { "count": 1, "type": "atleast" } } ] } }, "response_id": "cNjnTEJw", "type": "custom_segment" }

Authorizations

Authorization

string

header

required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
Password: Use your API Key, which you can find within the Data tile.

For more information on authentication and getting your credentials, refer here.

Headers

MOE-APPKEY

string

required

This is the Workspace ID of your MoEngage account that must be passed with the request. You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).

You can send MOE-DBNAME with your database name instead of this header. The request must include one of the two.

MOE-DBNAME

string

Your MoEngage database name. Send this as an alternative to MOE-APPKEY when you identify the workspace by database name. Omit it when MOE-APPKEY is already present.

Path Parameters

string

required

The ID of the segment.

Body

application/json

The updated filter definition for the segment.

Request schema for updating an existing filter-based segment.

included_filters

object

required

The updated filter criteria for inclusion. Users matching these filters will be part of the segment.

Show child attributes

name

string

A new unique name for the segment.

excluded_filters

object

Optional. The updated filter criteria for exclusion. Users matching these filters are removed from the included set even if they satisfy included_filters.

Show child attributes

updated_by

string<email>

Email of the user performing the update (for example, [email protected]).

Response

Segment updated successfully. Returns the updated segment details including the new filter definition and metadata.

Response schema for filter segment operations (create/update).

data

object

Information about the segment.

Show child attributes

response_id

string

A unique identifier for this API response.

type

string

The type of resource referenced in the response.

Example:

"custom_segment"