# Delete Label

Deletes an internal label permanently and removes it from every object carrying it; the objects remain. Requires user confirmation of this label.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "labelId": {
      "type": "integer",
      "description": "ID of the label to delete",
      "minimum": 1
    },
    "confirm": {
      "type": "boolean",
      "description": "true only when the user asked to delete this label",
      "default": false
    },
    "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",
    "removedFromObjects"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "labelId": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "removedFromObjects": {
      "type": "integer"
    }
  }
}
```