Remove Labels from a Niche
remove_niche_labelsRemoves a niche from one or more labels by label ID, returning which labels were removed or already absent. Changes are all-or-nothing.
Instructions
Use this to take a niche out of one or more labels (ids from list_labels). Returns removed and notPresent. Undo with add_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": "remove_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 take the niche out of, 1-100, unique. Get them from `list_labels`. |