Skip to main content

Communications: deleting a list can clean up its people; archive, undo an import, and the same in your AI agent

Deleting a list used to leave every person behind in the workspace. DELETE /comm-api/api/lists/{id} now takes contacts=keep (default) or contacts=delete_orphans, plus dry_run=true; people who unsubscribed, bounced, complained or are suppressed are always kept. New: archive and restore a list, list and undo imports (batch_id), clean up people on no list, and a warning (or 409 with strict) when two lists share a name.

In an AI agent connected to Motorical, the same actions are tools. Deleting needs a new, separate permission (manage:comms.audience) that you approve once; every one of these tools shows what it would do before it does it.

Documentation changed