sweep-ace-web

List and bulk delete ace-web chat sessions with human approval.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill sweep-ace-web
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sweep-ace-web
Source: https://github.com/dimagi-internal/ace/tree/main/skills/sweep-ace-web
Command: npx skills add https://github.com/dimagi-internal/ace --skill sweep-ace-web

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually deleting large volumes of ace-web chat sessions is time-consuming, risky, and prone to human error, especially when accounting for cascading related data like ingest uploads, messages, and share tokens that must be cleaned up alongside sessions.

Core Features & Use Cases

  • Bulk Session Listing: Retrieves all chat sessions across workspaces the calling user has Owner or Editor access to on the deployed ace-web instance.
  • Grouped Review Report: Generates a human-readable report grouped by workspace, with session counts, source breakdowns, and linkage details to help users review exactly what will be deleted.
  • Safe Two-Step Workflow: Supports a recommend mode to preview the deletion plan without taking action, and an execute mode that only runs after explicit human approval of the listed session IDs.
  • Cascading Deletion: Leverages server-side cascading to automatically remove all associated data (ingest uploads, messages, session participants, share tokens, and drafts) when sessions are deleted, no manual cleanup required.
  • Use Case: For example, if you need to clear out stale test sessions or bulk-delete outdated chat data from a deployed ace-web instance, use this skill to generate a full list of eligible sessions, review the grouped plan, and execute the bulk delete only after confirming the scope.

Quick Start

Ask the AI to use the sweep-ace-web skill to list all deletable ace-web chat sessions, show you the grouped deletion plan, and run the bulk delete after you approve the listed sessions.

Frequently Asked Questions about sweep-ace-web

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bulk delete chat sessions in ace-web?

To bulk delete ace-web chat sessions, this skill lists all sessions across accessible workspaces, groups them for review, and executes the deletion only after receiving explicit human approval of the listed session IDs.

What data is removed when I delete ace-web chat sessions?

Deleting ace-web chat sessions triggers server-side cascading deletion that automatically removes all associated ingest uploads, messages, session participants, share tokens, and draft records linked to those sessions.

Do I need a Personal Access Token to clean up ace-web session data?

Yes, cleaning up ace-web session data requires a valid ace-web Personal Access Token to authenticate with the sweep API endpoints used for listing and bulk deleting chat sessions.

Can I preview which ace-web sessions will be deleted before executing?

Yes, you can use the recommend mode to preview the deletion plan, which generates a human-readable report grouped by workspace with session counts, source breakdowns, and linkage details before any execute action is taken.

Which ace-web workspaces can I bulk delete chat sessions from?

You can bulk delete chat sessions from workspaces where your calling user account has either Owner or Editor access on the deployed ace-web instance.

What is the safest way to remove stale chat data from a deployed ace-web instance?

The safest way to remove stale chat data is using a recommend-then-execute workflow that requires explicit human approval of the listed session IDs before performing the server-side bulk deletion.