Unarchive Segment

This API unarchives an existing segment, making it active again.

PATCH /v2/custom-segments/unarchive

Unarchive Segment

cURL

curl --request PATCH \
  --url https://api-{dc}.moengage.com/v2/custom-segments/unarchive \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "custom_segment_unique_name"
}
'

202

{
  "message": "Successfully unarchived the custom segment",
  "success": true,
  "cs_name": "custom_segment_unique_name"
}

This API endpoint does not currently support Team-level scoping. All segments generated using this call will be assigned to the Default Team automatically.

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.

Body

application/json

The name of the segment to be unarchived.

Schema for requests that only require the segment name.

name · string · required

The name of the segment.

segment_id · string

Unique identifier corresponding to the target segment. When both segment_id and name are populated, the system prioritizes segment_id.

Response

202

application/json

Segment unarchive request accepted.

message · string

The status message of the request.

success · boolean

Indicates if the request was accepted.

Example:

true

cs_name · string

The unique name of the segment being processed.