Update task by ID
The Update Task by ID robot modifies an existing Bitrix24 (Alaio) task by its ID from any business process context. Fields are passed as JSON with UPPERCASE codes (TITLE, RESPONSIBLE_ID, DEADLINE, PRIORITY, etc.) and applied via the tasks.task.update method. It returns a Success (Y/N) flag based on the result of the API call.
The robot updates an existing task by its ID by calling the tasks.task.update method. The input is a numeric task ID and a set of fields as JSON; field codes are given in UPPERCASE as required by the tasks API — for example, {"TITLE":"New title","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"}. When to use it: reassign the responsible person or change the deadline when a deal moves to a new stage; append a stage marker to the title; raise the priority based on a process condition. The robot returns Success (Y/N): N if the ID is missing, the JSON is empty or invalid, or the API returned an error (the error text goes to the log). Use the Success flag in the condition of the next step to split the successful and failed update branches.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Task ID | int | yes | |
| Fields to update (UPPERCASE JSON): {"TITLE":"New title","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"} | string | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Success (Y/N) | string |
Scenario: reassigning a task when a deal advances
- A deal moves to the In progress stage
- The robot calls the task update by its ID with the fields {"RESPONSIBLE_ID":5}
- When Success = Y the process continues, on N it goes to the error-handling branch