# appointments_batch_archive

> Archive multiple appointments at once.

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

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

## Parameters

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

## Example prompts

- "Archive all my completed showings from last quarter in one sweep."
- "Archive those 12 old appointments, but run the list past me 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.
