---
title: "Update project status"
method: POST
path: "/projects/{id}/update_status"
tags: ["Projects"]
---

# Update project status

`POST /projects/{id}/update_status`

Updates the status of a project

## Path parameters

- `id` integer, required

## Request body

- object
  - `status_id` integer, required — ID of the new status (0 to clear status)

## Response `200`

Successfully updated project status

- object
  - `data` object
    - `id` integer
    - `name` string
    - `tax_year` integer, nullable
    - `project_status` ProjectStatus
      - `id` integer
      - `name` string
      - `position` integer

## Other responses

- `404` — Project or status not found

## Changes

- **2026-08-08** `7c956b3d1bdf` — 2 breaking, 3 warning, 1 info
  - added `#/components/schemas/ProjectStatus, subschema #2` to the `data/project_status` response property `oneOf` list for the response status `200`
  - the `data/project_status` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data/project_status/color` from the response with the `200` status
  - removed the optional property `data/project_status/id` from the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/gettruss/apis/api-v1/changes/projects/:id/update_status/post.md)

---

[API](https://skmtc.dev/gettruss/apis/api-v1.md) · [All operations](https://skmtc.dev/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gettruss/api-v1/revisions/7c956b3d1bdf/schema)