Изменить пункт чек-листа task.checklistitem.update

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: task

Кто может выполнять метод:

  • любой пользователь с доступом к редактированию задачи
  • постановщик, исполнитель и соисполнители задачи

Метод task.checklistitem.update изменяет существующий пункт чек-листа.

Проверить права на изменение пункта можно методом task.checklistitem.isactionallowed.

Параметры метода

Передавайте параметры в запросе в соответствии с порядком в таблице: TASKID, ITEMID, FIELDS. Значения разбираются по позиции, имена параметров не меняют порядок. Если нарушить порядок, запрос вернет ошибку или изменит другой пункт.

Если массив FIELDS передан на месте TASKID или ITEMID, метод возвращает ERROR_CORE с TASKS_ERROR_EXCEPTION_#256 о неверном типе соответствующего параметра. При перестановке двух идентификаторов результат зависит от доступности задачи и наличия пункта в ней.

Обязательные параметры отмечены *

Название
тип

Описание

TASKID*
integer

Идентификатор задачи.

Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач

ITEMID*
integer

Идентификатор пункта чек-листа.

Идентификатор пункта можно получить при добавлении нового пункта или методом получения списка пунктов чек-листа

FIELDS*
object

Объект с полями пункта чек-листа. Передайте только поля, которые нужно изменить

Параметр FIELDS

Название
тип

Описание

TITLE
string

Текст пункта чек-листа.

Если передать PARENT_ID со значением 0, то TITLE — название чек-листа

SORT_INDEX
integer

Индекс сортировки. Чем меньше значение, тем выше пункт в списке или подсписке

IS_COMPLETE
string

Статус выполнения пункта. Возможные значения:

  • Y — выполнен
  • N — не выполнен

Принимает также true и false. При смене статуса система заполняет поля TOGGLED_BY и TOGGLED_DATE

IS_IMPORTANT
string

Отметка, что пункт важный. Возможные значения:

  • Y — важный
  • N — обычный

Принимает также true и false

MEMBERS
object

Объект с описанием участников пункта чек-листа. Ключ — идентификатор пользователя, значение — объект с параметром типа участника TYPE. Возможные значения типа участника:

  • 'TYPE': 'A' — соисполнитель
  • 'TYPE': 'U' — наблюдатель

Поле MEMBERS заменяется полностью. Чтобы сохранить текущих участников, передайте их вместе с новыми значениями. Если у участника указан другой TYPE, метод без ошибки пропустит весь MEMBERS.

Система добавит участников пункта чек-листа в задачу в тех же ролях

PARENT_ID
integer

Идентификатор родительского пункта. Используйте для вложенных чек-листов.

  • Если передать PARENT_ID со значением 0, система создаст в задаче новый чек-лист
  • Если пункта с указанным PARENT_ID нет, пункт сохранится с этим PARENT_ID и не попадет ни в один чек-лист. Передавайте только идентификаторы существующих пунктов задачи
  • Если переместить корневой пункт чек-листа под пункт другого чек-листа, то он переместится вместе со своими подпунктами с сохранением иерархии. Чек-листы объединятся в один

Примеры кода

Как использовать примеры в документации

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":13,"ITEMID":475,"FIELDS":{"TITLE":"Подготовить отчет","PARENT_ID":447,"SORT_INDEX":100,"IS_COMPLETE":"N","IS_IMPORTANT":"N","MEMBERS":{"547":{"TYPE":"A"},"125":{"TYPE":"U"}}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.checklistitem.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":13,"ITEMID":475,"FIELDS":{"TITLE":"Подготовить отчет","PARENT_ID":447,"SORT_INDEX":100,"IS_COMPLETE":"N","IS_IMPORTANT":"N","MEMBERS":{"547":{"TYPE":"A"},"125":{"TYPE":"U"}}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/task.checklistitem.update
// 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

// Shape of the payload returned in result (match the "response handling" section of the page)
type ChecklistItemUpdateResult = null

try {
  const response = await $b24.actions.v2.call.make<ChecklistItemUpdateResult>({
    method: 'task.checklistitem.update',
    params: {
      TASKID: 13,
      ITEMID: 475,
      FIELDS: {
        TITLE: 'Подготовить отчет',
        PARENT_ID: 447,
        SORT_INDEX: 100,
        IS_COMPLETE: 'N',
        IS_IMPORTANT: 'N',
        MEMBERS: {
          547: { TYPE: 'A' },
          125: { TYPE: 'U' },
        },
      },
    },
    requestId: Text.getUuidRfc4122()
  })

  // 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('Checklist item updated successfully, result:', result)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function updateChecklistItem() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'task.checklistitem.update',
        params: {
          TASKID: 13,
          ITEMID: 475,
          FIELDS: {
            TITLE: 'Подготовить отчет',
            PARENT_ID: 447,
            SORT_INDEX: 100,
            IS_COMPLETE: 'N',
            IS_IMPORTANT: 'N',
            MEMBERS: {
              547: { TYPE: 'A' },
              125: { TYPE: 'U' },
            },
          },
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Checklist item updated successfully, result:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', updateChecklistItem)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException

fields = {
    "TITLE": "Подготовить отчет",
    "PARENT_ID": 447,
    "SORT_INDEX": 100,
    "IS_COMPLETE": "N",
    "IS_IMPORTANT": "N",
    "MEMBERS": {
        "547": {
            "TYPE": "A",
        },
        "125": {
            "TYPE": "U",
        },
    },
}

try:
    bitrix_response = client.task.checklistitem.update(
        task_id=13,
        item_id=475,
        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}")
try {
    $response = $b24Service
        ->core
        ->call(
            'task.checklistitem.update',
            [
                'TASKID' => 13,
                'ITEMID' => 475,
                'FIELDS' => [
                    'TITLE' => 'Подготовить отчет',
                    'PARENT_ID' => 447,
                    'SORT_INDEX' => 100,
                    'IS_COMPLETE' => 'N',
                    'IS_IMPORTANT' => 'N',
                    'MEMBERS' => [
                        547 => [
                            'TYPE' => 'A'
                        ],
                        125 => [
                            'TYPE' => 'U'
                        ]
                    ]
                ]
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    echo 'Success: ' . print_r($result, true);
    processData($result);

} catch (Throwable $e) {
    error_log($e->getMessage());
    echo 'Error updating checklist item: ' . $e->getMessage();
}
BX24.callMethod(
    'task.checklistitem.update',
    {
        'TASKID': 13,
        'ITEMID': 475,
        'FIELDS': {
            'TITLE': 'Подготовить отчет',
            'PARENT_ID': 447,
            'SORT_INDEX': 100,
            'IS_COMPLETE': 'N',
            'IS_IMPORTANT': 'N',
            'MEMBERS': {
                547: {
                    'TYPE': 'A'
                },
                125: {
                    'TYPE': 'U'
                }
            }
        }
    },
    function(result){
        console.info(result.data());
        console.log(result);
    }
);
require_once('crest.php');

$result = CRest::call(
    'task.checklistitem.update',
    [
        'TASKID' => 13,
        'ITEMID' => 475,
        'FIELDS' => [
            'TITLE' => 'Подготовить отчет',
            'PARENT_ID' => 447,
            'SORT_INDEX' => 100,
            'IS_COMPLETE' => 'N',
            'IS_IMPORTANT' => 'N',
            'MEMBERS' => [
                547 => [
                    'TYPE' => 'A'
                ],
                125 => [
                    'TYPE' => 'U'
                ]
            ]
        ]
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "task.checklistitem.update", b24.Params{
	"TASKID": 13,
	"ITEMID": 475,
	"FIELDS": b24.Params{
		"TITLE":        "Подготовить отчет",
		"PARENT_ID":    447,
		"SORT_INDEX":   100,
		"IS_COMPLETE":  "N",
		"IS_IMPORTANT": "N",
		"MEMBERS": b24.Params{
			"547": b24.Params{
				"TYPE": "A",
			},
			"125": b24.Params{
				"TYPE": "U",
			},
		},
	},
})
if err != nil {
	return fmt.Errorf("task.checklistitem.update: %w", err)
}

// При успехе result равен null
fmt.Printf("%s\n", res.Result)

Обработка ответа

HTTP-статус: 200

{
    "result": null,
    "time": {
        "start": 1762432505,
        "finish": 1762432505.206889,
        "duration": 0.20688891410827637,
        "processing": 0,
        "date_start": "2025-11-06T15:35:05+03:00",
        "date_finish": "2025-11-06T15:35:05+03:00",
        "operating_reset_at": 1762433105,
        "operating": 0.13953208923339844
    }
}

Возвращаемые данные

Название
тип

Описание

result
null

Возвращает null, если пункт чек-листа успешно обновлен.

Метод вернет null и в том случае, если передать пустой FIELDS или пустой TITLE: пункт при этом не изменится. Чтобы проверить результат, получите пункт методом task.checklistitem.get

time
time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"ERROR_CORE",
    "error_description":"TASKS_ERROR_EXCEPTION_#4; Нет доступа к редактированию задачи; 4/TE/ACTION_NOT_ALLOWED<br>"
}

Название
тип

Описание

error
string

Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только error_description

error_description
string

Текст ошибки для разработчика. Не показывайте его конечному пользователю без обработки

Возможные коды ошибок

Код

Описание

Значение

ERROR_CORE

TASKS_ERROR_EXCEPTION_#4; Нет доступа к редактированию задачи; 4/TE/ACTION_NOT_ALLOWED

У пункта есть участники MEMBERS, а у пользователя нет права изменять задачу, чтобы добавить их в нее. Изменения пункта при этом уже сохранены

ERROR_CORE

TASKS_ERROR_EXCEPTION_#512; Check listitem not found or not accessible

Пункт с идентификатором ITEMID не найден или недоступен при первоначальной проверке. Такая ошибка возможна и при перестановке TASKID и ITEMID, если задача, определенная по первому параметру, доступна, но в ней нет пункта с идентификатором из второго параметра

ERROR_CORE

TASKS_ERROR_EXCEPTION_#8; Checklist item not found or not accessible

Пункт исчез между чтением и сохранением

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) expected by method ctaskchecklistitem::update(), but not given.; 256/TE/WRONG_ARGUMENTS

Не передан обязательный параметр TASKID

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskchecklistitem::update() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS

Указан неверный тип значения для TASKID

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #1 (itemId) expected by method ctaskchecklistitem::update(), but not given.; 256/TE/WRONG_ARGUMENTS

Не передан обязательный параметр ITEMID

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #1 (itemId) for method ctaskchecklistitem::update() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS

Указан неверный тип значения для ITEMID

ERROR_CORE

TASKS_ERROR_ASSERT_EXCEPTION

Значение TASKID или ITEMID меньше или равно нулю

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #2 (arFields) expected by method ctaskchecklistitem::update(), but not given.; 256/TE/WRONG_ARGUMENTS

Не передан обязательный параметр FIELDS

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #2 (arFields) for method ctaskchecklistitem::update() expected to be of type "array", but given something else.; 256/TE/WRONG_ARGUMENTS

Третий параметр должен быть массивом FIELDS. Передан неверный тип, в том числе из-за нарушения порядка параметров

ERROR_CORE

TASKS_ERROR_EXCEPTION_#8; Bitrix\Tasks\CheckList\Internals\CheckListTree::canAttach: Невозможно создать зацикленную связь [261, 267]; 8/TE/ACTION_FAILED_TO_BE_PROCESSED

В PARENT_ID передан подпункт изменяемого пункта

ERROR_CORE

TASKS_ERROR_EXCEPTION_#8; Bitrix\Tasks\CheckList\Internals\CheckListTree::canAttach: Невозможно привязать узел к себе [261, 261]; 8/TE/ACTION_FAILED_TO_BE_PROCESSED

В PARENT_ID передан идентификатор самого пункта

ERROR_CORE

TASKS_ERROR_EXCEPTION_#256; Param #2 (arFields) for method ctaskchecklistitem::update() must not contain key "ID".; 256/TE/WRONG_ARGUMENTS

В FIELDS передано поле, которое нельзя изменить. Изменять можно только поля из таблицы параметра FIELDS

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус

Код
Текст ошибки

Описание

500

INTERNAL_SERVER_ERROR
Internal server error

Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24

500

ERROR_UNEXPECTED_ANSWER
Server returned an unexpected response

Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24

503

QUERY_LIMIT_EXCEEDED
Too many requests

Превышен лимит на интенсивность запросов

429

OPERATION_TIME_LIMIT
Method is blocked due to operation time limit

Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит

401

NO_AUTH_FOUND
Wrong authorization data

В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука

401

INVALID_REQUEST
Https required

Методы вызываются только по протоколу HTTPS

401

OVERLOAD_LIMIT
REST API is blocked due to overload

REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24

401

ACCESS_DENIED
REST is available only on commercial plans

REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — REST is available only by subscription

403

FEATURE_NOT_AVAILABLE_ON_CURRENT_PLAN
Функция недоступна на текущем тарифе.

Приложение Маркетплейса заблокировано, потому что число установленных приложений превышает лимит тарифа. События такому приложению не доставляются. Приложения, освобожденные от лимита, не блокируются

401

INVALID_CREDENTIALS
Invalid request credentials

Не найден активный вебхук с указанным идентификатором пользователя и секретным кодом

404

ERROR_METHOD_NOT_FOUND
Method not found!

Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа

401

insufficient_scope
The request requires higher privileges than provided by the webhook token

Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на provided by the access token

401

expired_token
The access token provided has expired

Срок действия access-токена истек

401

user_access_error
The user does not have access to the application

Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям

403

PORTAL_DELETED
Portal was deleted

Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение