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

# Update Project Internal State

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

Update admin-only operational project status/notes.

This is deliberately separate from the customer-facing status endpoint:
it does not notify the customer and does not trigger quote, payment,
DFM, or pricing side effects.

## Path parameters

- `project_id` string, uuid, required

## Request body

- AdminProjectInternalUpdate — Admin-only operational status and notes for a project.
  - `internal_status` string, nullable — Internal-only operational status slug. Null clears the status.
  - `internal_notes` string, nullable — Internal-only notes for admins. Null or blank clears the notes.

## Response `200`

Successful Response

- AdminProjectInternalStateResponse — Response after updating admin-only internal project state.
  - `id` string, uuid, required
  - `internal_status` string, nullable
  - `internal_notes` string, nullable
  - `updated_at` string, date-time, required

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