Delete messages in bulk

Delete a set of messages, or the oldest messages in the account. This is the v3 equivalent of the v1 message_delete_list action.

Send either ids (at most 25) or deleteFirst (1 to 10), never both. deleteFirst is the bounded replacement for v1's _all sentinel, matching Delete multiple campaigns; the sentinel itself is not accepted, and neither is a bare array body.

A message a campaign still references cannot be removed without breaking that campaign's history, so it is hidden instead, exactly as v1 did: those ids come back in hidden, the ids removed outright in deleted, and the ids that were neither in failed. With deleteFirst, a message that is already gone when its turn comes is skipped rather than reported as a failure.

Messages are deleted under the campaign delete permission.

Body Params
ids
array of int32s
length ≤ 25

Ids of the messages to delete. Positive integers, at most 25, and mutually exclusive with deleteFirst.

ids
int32
1 to 10

Delete this many of the oldest messages in the account. Between 1 and 10, and mutually exclusive with ids.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json