---
title: "Update"
method: PATCH
path: "/projects/{nameOrId}"
tags: ["projects"]
---

# Update

`PATCH /projects/{nameOrId}`

Updates a project by name or ID.

## Path parameters

- `nameOrId` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateProjectRequest
  - `name` string — The name of the project. Can only contain lowercase letters, numbers and hyphens. Must be unique within the workspace.
  - `default_agent` string, nullable — The name of the new project's default agent. Set to `null` to remove the default agent.
  - `max_active_conversations` integer, nullable — Maximum number of concurrent conversations allowed for this project. When `null`, the workspace `max_active_conversations` limit is used.

## Response `200`

Success response

- ProjectsUpdateResponse200
  - `success` boolean, required — Whether the project was updated successfully.

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized (authentication missing or invalid)
- `403` — Forbidden
- `404` — Project not found
- `500` — Internal server error

---

[API](https://skmtc.net/phonic/apis/api-reference.md) · [All operations](https://skmtc.net/phonic/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phonic/api-reference/revisions/7f8c81a5a990/schema)