# Update Label

Updates a label's name or note; omitted values stay. A new name appears on every object that carries the label.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "labelId": {
      "type": "integer",
      "description": "ID of the label to change",
      "minimum": 1
    },
    "name": {
      "type": [
        "null",
        "string"
      ],
      "description": "New name, unique within the account, without HTML; omit to keep",
      "default": null,
      "minLength": 1,
      "maxLength": 250
    },
    "notes": {
      "type": [
        "null",
        "string"
      ],
      "description": "Internal note; an empty string removes it; omit to keep",
      "default": null,
      "maxLength": 1000
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account of the access token",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "labelId"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "labelId",
    "name",
    "notes",
    "usageCount",
    "usedBy",
    "editUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "labelId": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "usageCount": {
      "type": "integer"
    },
    "usedBy": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      }
    },
    "editUrl": {
      "type": "string"
    }
  }
}
```