# leads_batch_archive

> Archive multiple leads at once.

<!-- Source: https://docs.actuallycare.com/tools/bulk-operations/leads_batch_archive -->

Archive multiple leads at once. Sets lead status to "archived" and marks them as soft-deleted. Returns success and failure counts with IDs. Use [`leads_list`](/tools/leads/leads_list) first to verify the correct lead IDs.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ids` | array of strings | Yes | Lead UUIDs to archive. Max 100. · Max items: 100 · Min items: 1 |

## Example prompts

- "Archive every lead from the 2024 open house list that never responded."
- "Archive those 50 dead sign-call leads, but show me which ones before you do."

## Safety

**Bulk changes.** Changes many records in one call. Review the scope carefully before confirming — bulk changes are treated as destructive because of their blast radius.
