---
title: "PM · Statuses · Update a status column title, color, or position"
method: PATCH
path: "/api/v1/pm/boards/{board_id}/status/{status_id}"
tags: ["statuses"]
---

# PM · Statuses · Update a status column title, color, or position

`PATCH /api/v1/pm/boards/{board_id}/status/{status_id}`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/pm/boards/{board_id}/status/{status_id}`
- Auth: API key in header `Authorization`

Partial update for a status column. All fields optional. Pass `order` (integer)
to reposition the column in the board view — other columns shift automatically.
Updatable fields: `title`, `description`, `color`, `order`.

## Path parameters

- `board_id` string, uuid, required
- `status_id` string, uuid, required

## Headers

- `Organization` string
- `Space` string

## Request body

- StatusUpdateRequest: Partial status update. All fields optional.
  - `title` string
  - `description` string
  - `color` string
  - `order` integer: Pass to reposition this status column.

## Response `200`

Status updated.

- unknown

---

[API](https://skmtc.dev/simplified/apis/project-manager.md) - [All operations](https://skmtc.dev/simplified/apis/project-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/project-manager/revisions/9ef06e133a13?raw)