Add Labels to a Niche
add_niche_labelsAdds a niche to one or more labels in a single all-or-nothing call. Returns added and already-present counts so users can confirm changes, and supports undo via label removal.
Instructions
Use this to put a niche in one or more labels (ids from list_labels). Returns added and alreadyPresent. Undo with remove_niche_labels. The same rights as the web app: the user needs Manage access to the niche, and to every Space added or removed. A refusal is a 403, so tell the user instead of retrying. A change is all or nothing: if any id is unknown, or a Space is one the user has only view rights on, the whole call fails and nothing changes (the error lists the offending ids). Ids already in the wanted state are counted, never errors, so a repeat is safe. Costs nothing. Limited to 2 calls per minute per niche, so put every id in one call.
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": {
"nicheId": "<nicheId>",
"labelIds": "<labelIds>"
},
"name": "add_niche_labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nicheId | Yes | The niche to change. Get one from `list_niches`. | |
| labelIds | Yes | The ids of the labels to add the niche to, 1-100, unique. Get them from `list_labels`. |