---
title: "Update a project"
method: PATCH
path: "/v2/projects/{project_id}"
tags: ["Projects"]
---

# Update a project

`PATCH /v2/projects/{project_id}`

Updates the specified project by setting the values of the parameters passed.

## Path parameters

- `project_id` string, required

## Request body

- UpdateProjectRequest
  - `name` string — New project name. Omit to keep the current name.
  - `teams` string[] — Replacement list of team identifiers associated with the project. Leave empty to remove all team associations.
  - `description` string — New project description. Omit to keep the current description.

## Response `200`

OK

- UpdateProjectResponse
  - `project` Project, required
    - `project_id` string, required — Unique project identifier assigned by ORQ. Use this value in retrieve, update, and delete requests.
    - `name` string, required — Human-readable project name.
    - `key` string, required — Stable project key generated from the name and used by internal workspace navigation.
    - `is_archived` boolean, required — Whether the project is archived and hidden from normal active project lists.
    - `is_default` boolean, required — Whether this is the workspace default project.
    - `teams` string[], required — Team identifiers associated with the project for access and organization.
    - `created_at` string, date-time, required — Time when the project was created.
    - `updated_at` string, date-time, required — Time when the project was last updated.
    - `created_by_id` string — User ID that created the project.
    - `updated_by_id` string — User ID that last updated the project.
    - `description` string — Optional human-readable description of the project.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/41c02aedc7c0/schema)