Audience

Update a segment

Partially update a segment. Requires the audience:write scope and is blocked for sandbox API keys.

patch/audience/segments/{segmentId}

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/audience/segments/{segmentId}
  • Auth: HTTP bearer

Path parameters

segmentIdstring uuid required

Segment ID

Request body

namestring
list_idstring uuid nullable

Example request

{
  "conditions": {
    "groups": [
      {
        "conditions": [
          {
            "field": "email",
            "operator": "equals",
            "value": "@example.com"
          }
        ]
      }
    ]
  }
}

Response

Updated

messagestring required

Example response

{
  "message": "Segment retrieved successfully.",
  "data": {
    "name": "Engaged subscribers",
    "condition_groups": [
      {
        "conditions": [
          {
            "field": "email",
            "operator": "equals",
            "value": "@example.com"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.