# tasks.task.update URL: https://chugunov.pro/api-bitrix24/tasks/tasks-task-update/ Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c). Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является. Изменить задачу Scope: `task` Кто может выполнять метод: любой пользователь с доступом к редактированию задачи ## Описание Метод `tasks.task.update` обновляет задачу. ## Параметры - `taskId` `integer` — обязательный. Идентификатор задачи. Идентификатор задачи можно получить при [создании новой задачи](https://chugunov.pro/api-bitrix24/tasks/tasks-task-add/) или методом [получения списка задач](https://chugunov.pro/api-bitrix24/tasks/tasks-task-list/) - `fields` `object` — обязательный. Значения [полей задачи](https://apidocs.bitrix24.ru/api-reference/tasks/fields.html). В параметре нужно передать хотя бы одно поле, иначе метод вернет ошибку. В метод можно передать параметр `SE_PARAMETER` — список объектов с дополнительными параметрами задачи. Возможные значения кодов `CODE`: - `1` — сроки определяются сроками подзадач - `2` — автоматически завершать задачу при завершении подзадач (и наоборот) - `3` — не завершать задачу без результата ```js SE_PARAMETER: [ { VALUE: 'Y', CODE: 3 }, { VALUE: 'Y', CODE: 2 } ] ``` ## Ответ HTTP-статус: 200 ```json { "result": { "task": { "id": "8157", "title": "Пример задачи", "description": "Описание задачи с [B]форматированием[/B]", "description": "", "mark": null, "priority": "1", "multitask": "N", "notViewed": "N", "replicate": "N", "stageId": "0", "sprintId": null, "backlogId": null, "createdBy": "503", "createdDate": "2025-10-06T17:40:12+03:00", "responsibleId": "503", "changedBy": "503", "changedDate": "2025-10-07T16:32:02+03:00", "statusChangedBy": "503", "closedBy": "0", "closedDate": null, "activityDate": "2025-10-07T16:29:55+03:00", "dateStart": null, "deadline": "2025-12-31T23:59:00+03:00", "startDatePlan": "2024-11-02T11:06:00+03:00", "endDatePlan": "2024-11-02T19:06:00+03:00", "guid": "{1a90e51d-5423-4c1e-b1a2-664a519b4612}", "xmlId": null, "commentsCount": "4", "serviceCommentsCount": "4", "allowChangeDeadline": "N", "allowTimeTracking": "N", "taskControl": "N", "addInReport": "N", "forkedByTemplateId": null, "timeEstimate": "0", "timeSpentInLogs": null, "matchWorkTime": "N", "forumTopicId": "1439", "forumId": "11", "siteId": "s1", "subordinate": "Y", "exchangeModified": null, "exchangeId": null, "outlookVersion": "8", "viewedDate": "2025-10-07T16:30:34+03:00", "sorting": null, "durationFact": null, "isMuted": "N", "isPinned": "N", "isPinnedInGroup": "N", "flowId": null, "descriptionInBbcode": "Y", "status": "2", "statusChangedDate": "2025-10-07T16:22:24+03:00", "durationPlan": "0", "durationType": "days", "favorite": "N", "groupId": "0", "auditors": ["503", "547"], "accomplices": [], "checklist": [], "group": [], "creator": { "id": "503", "name": "Мария Иванова", "link": "/company/personal/user/503/", "icon": "https://mysite.ru/b17053/resize_cache/45749/c0120a8d7c10d63c83e32398d1ec4d9e/main/c89/c89c6b7301880958ea704b5a8470635c/4R5A1256.png", "workPosition": "Администратор" }, "responsible": { "id": "503", "name": "Мария Иванова", "link": "/company/personal/user/503/", "icon": "https://mysite.ru/b17053/resize_cache/45749/c0120a8d7c10d63c83e32398d1ec4d9e/main/c89/c89c6b7301880958ea704b5a8470635c/4R5A1256.png", "workPosition": "Администратор" }, "accomplicesData": [], "auditorsData": { "547": { "id": "547", "name": "Елена", "link": "/company/personal/user/547/", "icon": "/bitrix/images/tasks/default_avatar.png", "workPosition": "Юрист" } }, "newCommentsCount": 0, "action": { "accept": false, "decline": false, "complete": true, "approve": false, "disapprove": false, "start": true, "pause": false, "delegate": true, "remove": true, "edit": true, "defer": true, "renew": false, "create": true, "changeDeadline": true, "checklistAddItems": true, "addFavorite": true, "deleteFavorite": false, "rate": true, "take": false, "edit.originator": false, "checklist.reorder": true, "elapsedtime.add": true, "dayplan.timer.toggle": false, "edit.plan": true, "checklist.add": true, "favorite.add": true, "favorite.delete": false }, "checkListTree": { "nodeId": 0, "fields": { "id": null, "copiedId": null, "entityId": null, "userId": 503, "createdBy": null, "parentId": null, "title": "", "sortIndex": null, "displaySortIndex": "", "isComplete": false, "isImportant": false, "completedCount": 0, "members": [], "attachments": [], "nodeId": null }, "action": [], "descendants": [] }, "checkListCanAdd": true } }, "time": { "start": 1759843922, "finish": 1759843922.725389, "duration": 0.7253890037536621, "processing": 0, "date_start": "2025-10-07T16:32:02+03:00", "date_finish": "2025-10-07T16:32:02+03:00", "operating_reset_at": 1759844522, "operating": 0.4929828643798828 } } ``` ### Возвращаемые данные - `result` `object`. Объект с данными ответа - `task` `object`. Объект с [описанием задачи](https://apidocs.bitrix24.ru/api-reference/tasks/fields.html) после выполнения операции - `time` `time`. Информация о времени выполнения запроса ## Ошибки HTTP-статус: 400 ```json { "error": "ERROR_CORE", "error_description": "Невозможно привязать узел к самому себе\u003Cbr\u003E" } ``` - `0` — wrong task id. В параметре `taskId` указано значение неверного типа - `100` — CTaskItem All parameters in the constructor must have real class type (internal error). Не передан обязательный параметр `taskId` - `0` — Действие над задачей не разрешено (internal error). У пользователя нет прав обновление задачи или нет доступа к задаче - `100` — Could not find value for parameter {fields} (internal error). Не передан параметр `fields` или передан пустой - `ERROR_CORE` — Пользователь указанный в поле \u0026quot;Исполнитель\u0026quot; не найден\u003Cbr\u003E. В поле `RESPONSIBLE_ID` указан идентификатор несуществующего пользователя - `ERROR_CORE` — Некорректный статус\u003Cbr\u003E. Указано некорректное значение в поле `STATUS` - `ERROR_CORE` — Задача указанная в поле \u0026quot;Надзадача\u0026quot; не найдена\u003Cbr\u003E. В поле `PARENT_ID` указан идентификатор несуществующей задачи - `ERROR_CORE` — Невозможно привязать узел к самому себе\u003Cbr\u003E. В поле `PARENT_ID` указан идентификатор той же задачи, что и в параметре `taskId` - `ERROR_CORE` — Создание зацикленных связей в задачах запрещено\u003Cbr\u003E. В поле `PARENT_ID` указан идентификатор подзадачи `taskId`. Подзадача не может стать базовой задачей - `ERROR_CORE` — В планировании сроков указана дата окончания меньшая даты старта\u003Cbr\u003E. Дата и время в поле `END_DATE_PLAN` указано меньше, чем в `START_DATE_PLAN` - `ERROR_CORE` — В планировании сроков указана слишком большая длительность задачи\u003Cbr\u003E. В значении поля `END_DATE_PLAN` указана слишком большая дата ## Примеры запроса ### cURL (Webhook) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"taskId":11,"fields":{"UF_CRM_TASK":["L_4","C_7","CO_5","D_10"],"UF_TASK_WEBDAV_FILES":["n12345","n67890"],"RESPONSIBLE_ID":123}}' \ https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.update ``` ### cURL (OAuth) ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"taskId":11,"fields":{"UF_CRM_TASK":["L_4","C_7","CO_5","D_10"],"UF_TASK_WEBDAV_FILES":["n12345","n67890"],"RESPONSIBLE_ID":123},"auth":"**put_access_token_here**"}' \ https://**put_your_bitrix24_address**/rest/tasks.task.update ``` ### JS (TS) ```ts // This snippet is an ES module: top-level await requires type="module" or a bundler. // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide). import { Text } from '@bitrix24/b24jssdk' import type { B24Frame } from '@bitrix24/b24jssdk' declare const $b24: B24Frame // Minimal shape of result.task; the API returns the full task object // Shape of the payload returned in result (match the "response handling" section of the page) type TaskUpdateResult = { task: { id: string } } try { const response = await $b24.actions.v2.call.make({ method: 'tasks.task.update', params: { taskId: 11, // ID of the task to update fields: { // Bind the task to several CRM entities via UF_CRM_TASK UF_CRM_TASK: ['L_4', 'C_7', 'CO_5', 'D_10'], // Lead 4 / Contact 7 / Company 5 / Deal 10 // Attach several Drive files via UF_TASK_WEBDAV_FILES (prefix IDs with "n") UF_TASK_WEBDAV_FILES: ['n12345', 'n67890'], RESPONSIBLE_ID: 123 // New responsible person ID } }, requestId: Text.getUuidRfc4122() // optional unique tracking id for this request }) // The payload is available only on a successful response if (!response.isSuccess) { console.error(response.getErrorMessages().join('; ')) } else { const result = response.getData()!.result console.info(`Task ${result.task.id} updated`) } } catch (error) { // Thrown on transport or SDK failures (AjaxError, SdkError, etc.) console.error(error) } ``` ### JS (UMD) ```html ``` ### Python ```python from b24pysdk.errors import BitrixAPIError, BitrixSDKException fields = { "UF_CRM_TASK": [ "L_4", "C_7", "CO_5", "D_10", ], "UF_TASK_WEBDAV_FILES": [ "n12345", "n67890", ], "RESPONSIBLE_ID": 123, } try: bitrix_response = client.tasks.task.update( task_id=11, fields=fields, ).response result = bitrix_response.result print(result) except BitrixAPIError as error: print( "Ошибка Bitrix API", f"error: {error.error}", f"error_description: {error.error_description}", sep="\n", ) except BitrixSDKException as error: print(f"Ошибка Bitrix SDK: {error.message}") except Exception as error: print(f"Непредвиденная ошибка: {error}") ``` ### PHP ```php try { $response = $b24Service ->core ->call( 'tasks.task.update', [ 'taskId' => 11, // Идентификатор задачи, которую вы хотите обновить 'fields' => [ // Пример передачи нескольких значений в поле UF_CRM_TASK 'UF_CRM_TASK' => [ 'L_4', // Привязка к лиду с id 4 'C_7', // Привязка к контакту с id 7 'CO_5', // Привязка к компании с id 5 'D_10' // Привязка к сделке с id 10 ], // Пример передачи нескольких файлов в поле UF_TASK_WEBDAV_FILES 'UF_TASK_WEBDAV_FILES' => [ 'n12345', // Идентификатор первого файла диска 'n67890' // Идентификатор второго файла диска ], 'RESPONSIBLE_ID' => 123 // Идентификатор нового исполнителя ] ] ); $result = $response ->getResponseData() ->getResult(); echo 'Задача успешно обновлена'; } catch (Throwable $e) { error_log($e->getMessage()); echo 'Ошибка при обновлении задачи: ' . $e->getMessage(); } ``` ### BX24.js ```javascript BX24.callMethod( "tasks.task.update", { taskId: 11, // Идентификатор задачи, которую вы хотите обновить fields: { // Пример передачи нескольких значений в поле UF_CRM_TASK UF_CRM_TASK: [ "L_4", // Привязка к лиду с id 4 "C_7", // Привязка к контакту с id 7 "CO_5", // Привязка к компании с id 5 "D_10" // Привязка к сделкес id 10 ], // Пример передачи нескольких файлов в поле UF_TASK_WEBDAV_FILES UF_TASK_WEBDAV_FILES: [ "n12345", // Идентификатор первого файла диска "n67890" // Идентификатор второго файла диска ], RESPONSIBLE_ID: 123 // Идентификатор нового исполнителя } }, function(result) { if (result.error()) { console.error(result.error()); } else { console.info("Задача успешно обновлена"); } } ); ``` ### PHP CRest ```php require_once('crest.php'); $result = CRest::call( 'tasks.task.update', [ 'taskId' => 11, // Идентификатор задачи, которую вы хотите обновить 'fields' => [ // Пример передачи нескольких значений в поле UF_CRM_TASK 'UF_CRM_TASK' => [ 'L_4', // Привязка к лиду с id 4 'C_7', // Привязка к контакту с id 7 'CO_5', // Привязка к компании с id 5 'D_10' // Привязка к сделке с id 10 ], // Пример передачи нескольких файлов в поле UF_TASK_WEBDAV_FILES 'UF_TASK_WEBDAV_FILES' => [ 'n12345', // Идентификатор первого файла диска 'n67890' // Идентификатор второго файла диска ], 'RESPONSIBLE_ID' => 123 // Идентификатор нового исполнителя ] ] ); if (isset($result['error'])) { echo 'Ошибка: ' . $result['error_description']; } else { echo 'Задача успешно обновлена'; } ``` ### Go ```go // client и ctx уже созданы — см. раздел «SDK для Go» res, err := client.Core().Call(ctx, "tasks.task.update", b24.Params{ "taskId": 11, "fields": b24.Params{ "UF_CRM_TASK": []string{"L_4", "C_7", "CO_5", "D_10"}, "UF_TASK_WEBDAV_FILES": []string{"n12345", "n67890"}, "RESPONSIBLE_ID": 123, }, }) if err != nil { return fmt.Errorf("tasks.task.update: %w", err) } // Метод заворачивает ответ в объект с ключом "task". raw, ok := b24.Unwrap(res.Result, "task") if !ok { return fmt.Errorf("в ответе нет ключа task") } var item struct { ID b24.ID `json:"id"` Title string `json:"title"` Description string `json:"description"` Priority string `json:"priority"` Multitask string `json:"multitask"` NotViewed string `json:"notViewed"` } if err := json.Unmarshal(raw, &item); err != nil { return fmt.Errorf("разбор ответа: %w", err) } fmt.Println(item.ID, item.Title) ``` Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/tasks/tasks-task-update.html