---
title: "Update Project"
method: PATCH
path: "/api/v1/projects/{project_id}"
tags: ["projects"]
---

# Update Project

`PATCH /api/v1/projects/{project_id}`

Partially update a project.

Most fields can only be changed while in DRAFT status.
``shipping_address_id`` can be updated regardless of project status;
changing it will invalidate any active quotes (QUOTED/APPROVED).

## Path parameters

- `project_id` string, uuid, required

## Request body

- ProjectUpdate — Partial update for an existing project. All fields are optional — only supplied fields are applied. ``shipping_address_id`` can be updated regardless of project status; all other fields require the project to be in DRAFT status.
  - `name` string, nullable
  - `description` string, nullable
  - `priority` string, nullable
  - `target_delivery_date` string, date, nullable
  - `notes` string, nullable
  - `shipping_address_id` string, uuid, nullable

## Response `200`

Successful Response

- ProjectResponse — Project summary returned in list endpoints. Maps 1-to-1 with the ``Project`` SQLAlchemy model, excluding relationships to keep the payload lightweight.
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `notes` string, nullable
  - `status` string, required
  - `priority` string, required
  - `target_delivery_date` string, date, nullable
  - `shipping_address_id` string, uuid, nullable
  - `user_id` string, uuid, required
  - `part_count` integer, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `submitted_at` string, date-time, nullable
  - `order_placed_at` string, date-time, nullable
  - `expected_delivery_date_min` string, date, nullable
  - `expected_delivery_date_max` string, date, nullable

## Other responses

- `422` — Validation Error

---

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