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

# Update a project

`PATCH /v2/projects/{project_id}`

Update a project by its ID (rename).

**Payload Requirements**
- `name` must be provided and must be unique within the space.
- System-managed fields (`id`, `created_at`, `updated_at`) cannot be modified.

**Valid example**
```json
{
  "name": "Renamed Project"
}
```

**Invalid example** (empty body)
```json
{}
```

  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Path parameters

- `project_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Request body

- UpdateProjectRequest
  - `name` string, required — New project name. Must be unique within the space.

## Response `200`

A project object

- Project — A project represents an LLM application and serves as the primary container for observability data. Each project collects traces and spans that capture the execution flow of your application, enabling you to debug issues, monitor latency, and analyze token usage. Projects belong to a space and provide a centralized view of your application's performance. Use projects to organize related traces, run experiments against datasets, and track improvements over time.
  - `id` string, required — The project ID
  - `name` string, required — The project name
  - `space_id` string, required — The space ID the project belongs to
  - `created_at` string, date-time, required — When the project was created

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `422` — Unprocessable entity
- `429` — Rate limit exceeded

---

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