timeline_labels_apply

publ Reference
# timeline_labels_apply

Changes labels in the Timeline app (pApp A00001, or an instance code of the same family). Another app code is refused before any request. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `action` | Yes | one of: `create_general_label`, `rename_general_label`, `delete_general_label`, `order_general_labels` (by `kind`) |
| `action.name` | Yes | When `action.kind` is `create_general_label`: string; min length 1; max length 30 |
| `action.labelId` | Yes | When `action.kind` is `rename_general_label`: integer; greater than 0 |
| `action.name` | Yes | When `action.kind` is `rename_general_label`: string; min length 1; max length 30 |
| `action.labelId` | Yes | When `action.kind` is `delete_general_label`: integer; greater than 0 |
| `action.confirmation` | Yes | When `action.kind` is `delete_general_label`: `DELETE_GENERAL_LABEL` |
| `action.labelIds` | Yes | When `action.kind` is `order_general_labels`: array; items: integer; greater than 0; min items 1; max items 1000; Timeline only: every GENERAL label ID of the selected instance in the new display order, as the original order dialog submits. |
| `instanceCode` | No | string; pattern `^A(?:000\|9[0-9]{2})01$`; Optional: which installed Timeline app to use (its code, such as A00001 or A90101). Omit it when only one is installed; when several are, pick one from the installed list. |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |