---
title: "Move up to 100 cards to a column in one transaction"
method: POST
path: "/cards/bulk/move"
---

# Move up to 100 cards to a column in one transaction

`POST /cards/bulk/move`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/cards/bulk/move`
- Auth: HTTP bearer

Without `targetProjectId`, sweeps the cards to a column on their
own board - every id must belong to the same board (400
otherwise). With `targetProjectId`, moves the batch to that board
instead (same workspace only, mirroring the single-card move).
Moved cards append to the end of the target column in request
order. Within-board column changes are recorded to each card's
activity log. All-or-nothing; no notification emails.

## Request body

- object
  - `ids` string[], required
  - `column` string, required: Target column.key
  - `targetProjectId` string, uuid: Optional destination board (same workspace)

## Response `200`

Moved cards, in request order

- BulkCardsResponse
  - `cards` Card[], required: Affected cards, in request order
    - `id` string, uuid, required
    - `projectId` string, uuid, required
    - `column` string, required
    - `title` string, required
    - `description` string: Full body on GET /cards/{id}, PATCH, create, and /detail. Omitted from GET /projects/{id}/cards and lean SSE card.updated events (position-only moves).
    - `position` number, required
    - `dueDate` string, date-time, nullable
    - `assignedUserId` string, uuid, nullable
    - `assignedUserName` string, nullable
    - `size` integer, nullable: Optional integer size estimate; null when unset
    - `priority` 'low' | 'medium' | 'high' | 'urgent' | 'null', nullable
    - `createdBy` string, uuid, nullable
    - `createdByName` string, nullable
    - `updatedBy` string, uuid, nullable
    - `updatedByName` string, nullable
    - `attachmentCount` integer
    - `checklistDone` integer: Completed checklist items (denormalized count)
    - `checklistTotal` integer: Total checklist items (denormalized count)
    - `tags` string[]
    - `following` boolean: Whether the authenticated caller follows this card
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: Missing fields, too many items, or ids span multiple boards without a targetProjectId
- `404`: A card or the target board doesn't exist / isn't accessible; nothing was moved
- `422`: Target column doesn't exist

---

[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)