---
title: "Archive all cards in a column"
method: POST
path: "/columns/{id}/archive"
---

# Archive all cards in a column

`POST /columns/{id}/archive`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/columns/{id}/archive`
- Auth: HTTP bearer

Soft-archives every live card in the column - they leave the board
but stay searchable.

Only applies to a column flagged `isDone`. On any other column this
still answers `200` with `{"archived": 0}` rather than an error, so
check the count instead of relying on the status code.

## Response `200`

Count and ids of the cards archived

- object
  - `archived` integer, required
  - `ids` string[], required: Archived card ids, for an undo via POST /cards/{id}/restore

## Other responses

- `404`: Resource doesn't exist or caller isn't a member of its workspace

---

[API](https://skmtc.dev/craaft/apis/craaft-api.md) · [All operations](https://skmtc.dev/craaft/apis/craaft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craaft/apis/craaft-api/revisions/3a1e9d30d7dc?raw)
