# update_project

> 更新项目名称，并对调用方自定义的档案字段做浅合并。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/projects/update_project

> 更新项目名称，并对调用方自定义的档案字段做浅合并。档案值为 null 表示删除该字段。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/projects/update_project.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | Core (`core`) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定：显式的 `project` → 请求头 → 凭据默认项目 → 工作区默认项目 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `name` | 否 | `string` | 新的显示名称。省略则保持不变。 |
| `profile` | 否 | `object` | 要合并进档案的字段，例如 \{"audience": "agencies"\}。值为 null 表示删除该字段。 |
| `project` | 否 | `string` | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |

## 示例调用

```json
{
  "project": "acme-crm",
  "profile": {
    "audience": "agencies",
    "old_field": null
  }
}
```

REST:`POST https://service.opennomos.com/v1/tools/update_project`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "update_project"`，以上 JSON 作为 `arguments`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "project": {
    "id": "prj_k3Vd9aQx2",
    "slug": "acme-crm",
    "name": "Acme CRM",
    "profile": {
      "website": "https://acme.com",
      "audience": "agencies"
    },
    "memory_count": 12,
    "last_memory_at": "2026-10-15T10:02:11.000Z"
  }
}
```

## 说明

- 档案更新只在顶层合并：给出的键会覆盖，`null` 删除该键，省略的键保持不变。嵌套对象整体替换，不做深度合并。

## 错误

被拒绝的调用（输入有误、id 未知、触发限流）返回 `message` 和 `code`；走 MCP 时结果带 `isError: true`。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。