---
title: "Rewrite the board's column order"
method: PATCH
path: "/projects/{id}/columns/order"
tags: ["Projects"]
---

# Rewrite the board's column order

`PATCH /projects/{id}/columns/order`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/projects/{id}/columns/order`
- Auth: HTTP bearer

The COMPLETE order, not a move: the list must match the project's columns exactly (no duplicate, nothing missing, nothing foreign) or it is rejected as COLUMN_ORDER_MISMATCH — a partial list would leave the uncited columns on old positions, producing an order neither side chose. Applied in one transaction.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `columnIds` string[], required

## Response `200`

- object
  - `columns` ProjectColumn[], required
    - `id` string, uuid, required
    - `name` string, required
    - `kind` 'backlog' | 'active' | 'review' | 'done', required

## Other responses

- `400`: Validation error / COLUMN_ORDER_MISMATCH.
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: Not found, or the caller is not authorized to access this resource.

---

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