> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# issues_update_label

> Rename a label or change its colour, description, or archived state. A rename applies everywhere the label is used.

<div className="tool-route"><span className="tool-row-method" data-method="PATCH">PATCH</span><code>{"https://api.github.com/repos/{owner}/{repo}/labels/{name}"}</code></div>

```python github_issues_update_label.py theme={null}
from charter.packs import github

result = await github.issues_update_label.ainvoke({"owner": ..., "repo": ..., "name": ...})
```

<Note>
  Requires `repo`, `read:user`.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                         | Type     | Description                                                                              |
  | ------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------- |
  | `owner` <span className="required" title="required">\*</span> | `string` | The account owner of the repository. The name is not case sensitive.                     |
  | `repo` <span className="required" title="required">\*</span>  | `string` | The name of the repository without the `.git` extension. The name is not case sensitive. |
  | `name` <span className="required" title="required">\*</span>  | `string` | The current name of the label.                                                           |
</div>

## Body

<div className="reference-table">
  | Field         | Type      | Description                                                                                                                                        |
  | ------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `newName`     | `string`  | The new name of the label.                                                                                                                         |
  | `color`       | `string`  | The hexadecimal color code for the label, without the leading `#`. <span className="field-constraints">matches `^[0-9a-fA-F]&#123;6&#125;$`</span> |
  | `description` | `string`  | A short description of the label. Must be 100 characters or fewer. <span className="field-constraints">max length 100</span>                       |
  | `archived`    | `boolean` | Whether to archive or unarchive the label. Archived labels cannot be added to issues or pull requests.                                             |
</div>