---
title: "Update Project"
method: PATCH
path: "/projects/{projectId}"
---

# Update Project

`PATCH /projects/{projectId}`

## Request

- Base URL: `https://api2.scorecard.io/api/v2`
- URL: `https://api2.scorecard.io/api/v2/projects/{projectId}`
- Auth: HTTP bearer

Update a Project's name, description, or review status. Changing `status` requires an organization admin: an organization API key, or a token belonging to an admin. Keys and tokens scoped to an individual member receive a 403. `statusUpdatedAt` moves only when the status actually changes.

## Path parameters

- `projectId` string, required

## Request body

- object
  - `name` string: The new name of the Project.
  - `description` string: The new description of the Project.
  - `status` 'in_progress' | 'in_review' | 'completed' | 'null', nullable: The new review status of the Project. Only organization admins can change it. Pass `null` to stop tracking a status.

## Response `200`

Project updated successfully.

- Project: A Project in the Scorecard system.
  - `id` string, required: The ID of the Project.
  - `name` string, nullable, required: The name of the Project.
  - `description` string, nullable, required: The description of the Project.
  - `status` 'in_progress' | 'in_review' | 'completed' | 'null', nullable, required: The review status of the Project, set by an organization admin. `null` if the Project doesn't track a status.
  - `statusUpdatedAt` string, nullable, required: The ISO 8601 timestamp when `status` last changed. `null` if a status has never been set.

## Other responses

- `401`: Error indicating that the request is not authenticated.
- `403`: Error indicating that the caller is authenticated but not allowed to perform this operation.
- `500`: An internal service error indicating an issue with the Scorecard service.

## Changes

- **2026-10-28** `b40e47e06b7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/projects/:projectId/patch.md)

---

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