update-labels
Update existing Todoist labels by changing their name, color, order, or favorite status. Rename shared labels across all tasks.
Instructions
Update one or more existing labels. Personal labels (identified by ID) can have their name, color, order, and favorite flag updated. Shared labels (identified by name) can only be renamed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"labels": "<labels>"
},
"name": "update-labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labels | Yes | The labels to update. Use labelType="personal" with an ID to update a personal label, or labelType="shared" with name+newName to rename a shared label. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| totalCount | Yes | The total number of successful operations (personal + shared). | |
| updatedLabels | Yes | The updated personal labels. | |
| appliedOperations | Yes | Summary of operations performed. | |
| renamedSharedLabels | Yes | The shared labels that were renamed. |