Remove task tags by ID
The Remove Task Tags robot strips the named tags from a Bitrix24 task by its ID without touching the others. Tags are given as a list (one per line) and matched case-insensitively. It returns a Success flag (Y/N), the number of tags removed and the list of remaining tags for the next step of the process.
The robot removes only the listed tags from a Bitrix24 task, keeping all the rest. The input is a numeric task ID and a list of tags (a Multiple field, one tag per line); matching is case-insensitive and surrounding whitespace is dropped. Internally it reads the task's current tags, excludes the matched ones and writes the remainder via tasks.task.update (the API has no "remove one tag" operation, so the tag list is always rewritten in full). If none of the named tags are present on the task, no write happens and the robot reports there was nothing to remove. A typical scenario is stripping a "new" or "awaiting reply" label when a task moves to a given stage: the stage condition itself is configured in the automation rules or the business process, while the robot just removes the tag from the task whose ID you pass in. It returns Success (Y/N), the number of tags removed and the list of remaining tags — use them in the conditions and notifications of later steps.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Task ID | int | yes | |
| Tags to remove (one per line) | string | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Success (Y/N) | string |
| How many tags were removed | int |
| Remaining tags | string |
Scenario: strip the "new" tag when a task moves to the "In progress" stage
- In the stage automation rule add the Remove Task Tags robot
- Set Task ID to the current task and list "new" in the tags
- The robot returns Success = Y and removed_count = 1 if the tag was on the task