Audience

Bulk delete audience lists

Delete up to 50 lists in a single request. All list_ids must belong to the authenticated team. If any list has segments restricted to it, nothing is deleted and the response is 409 list_in_use. Requires the audience:write scope and is blocked for sandbox API keys.

delete/audience/lists/bulk

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/audience/lists/bulk
  • Auth: HTTP bearer

Request body

list_idsstring[] required

1–50 list IDs (all must belong to the authenticated team)

Example request

{
  "list_ids": [
    "0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0",
    "0193e6a8-2a4b-7d1c-a3f5-2bb2e3f6e4a1"
  ]
}

Response

OK

messagestring required

Example response

{
  "message": "Lists deleted successfully.",
  "data": {
    "deleted": 2
  }
}

Changes

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