list/delete_by_id

Tool: delete

Delete a mailing list.

Permanently deletes the list from the organization. Returns an {ok:true} acknowledgement.

Idempotent: deletes are idempotent — a 404 means this list is already gone (including because an earlier call already deleted it). Treat it as the desired end state, not a failure.

Deleting a non-empty list is allowed upstream (204, no guard): former members keep a dangling baseListId pointing at the deleted list. Move members first if that matters.

Arguments

Response

200 — {ok:true} acknowledgement (upstream: 204 No Content).

Errors: 400, 401, 404, 406, 422, 429, 500 — shared schema: schemas/errors.

Invoke

Call delete with name: "list/delete_by_id".