---
title: "Updating Project Details"
method: PATCH
path: "/v1/projects/{id}"
tags: ["Projects"]
---

# Updating Project Details

`PATCH /v1/projects/{id}`

The Project name may be updated, as well as the Project description and the `archived` flag.

By default, `archived` is not set, which is equivalent to `false`. If `archived` is set to `true`, the Project will be sorted to the bottom of the list, and in the web management application the Project will become effectively read-only. API write access will not be affected.

## Path parameters

- `id` number, required

## Response `200`

OK

- object
  - `id` number — The numerical ID of the Project.
  - `name` string, required — The name of the Project.
  - `description` string — The description of the Project, which is rendered as Markdown on Frontend.
  - `keyId` number — If managed encryption is enabled on the project, the numeric ID of the encryption key as tracked by Central is given here.
  - `archived` boolean — Whether the Project is archived or not. `null` is equivalent to `false`. All this does is sort the Project to the bottom of the list and disable management features in the web management application.

## Changes

- **2025-10-27** `b11b54eea487` — 1 info
  - removed the non-success response with the status `403`
- **2025-03-13** `e8c2858fd4eb` — 2 info
  - api operation id `updateProjectDetails` removed and replaced with `Updating Project Details`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:id/patch.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/712be4cf09b4/schema)