# CopyCannedCharacteristicInput

input type

Copy-input for copyCannedCharacteristic: the template key + optional caption/code overrides; the template payload (valueType/grammar/unit) copies VERBATIM — customize AFTER the copy via updateCharacteristic.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `key` | [String](/types/#scalars) `String!` | yes | The canned template key (cannedCharacteristics lists them) — an unknown key is refused VALIDATION/INVALID. |
| `caption` | [String](/types/#scalars) | no | Optional caption override; default = the template caption. |
| `code` | [String](/types/#scalars) | no | Optional code override; default = the template key. |

## Used by

- [copyCannedCharacteristic](/reference/catalog-structure/copyCannedCharacteristic/)