# update_project (/docs/reference/mcp-tools/update_project)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Update a project's name / description / icon / color / lead.

|                     |                   |
| ------------------- | ----------------- |
| Required permission | `work:write`      |
| Capability ID       | `projects.update` |
| Destructive         | No                |

## Parameters [#parameters]

| Parameter     | Type                  | Required | Notes |
| ------------- | --------------------- | -------- | ----- |
| `name`        | string                | no       |       |
| `description` | string \| null        | no       |       |
| `icon`        | string \| null        | no       |       |
| `color`       | string                | no       |       |
| `leadId`      | string (uuid) \| null | no       |       |
| `archived`    | boolean               | no       |       |
| `id`          | string (uuid)         | yes      |       |

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "icon": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "color": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "leadId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "archived": {
      "type": "boolean"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `work:write` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.