task.checklistitem.add
Добавить пункт чек-листа
Описание
Метод task.checklistitem.add добавляет новый пункт чек-листа в задаче.
Проверить права на добавление пункта можно методом task.checklistitem.isactionallowed.
Параметры
TASKID
integer
обязательный
Идентификатор задачи.
Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач
FIELDS
object
обязательный
Объект с полями пункта чек-листа
Параметр FIELDS
TITLE
string
обязательный
Текст пункта чек-листа.
Если передать PARENT_ID со значением 0, то TITLE — название чек-листа
SORT_INDEX
integer
необязательный
Индекс сортировки. Чем меньше значение, тем выше пункт в списке или подсписке
IS_COMPLETE
boolean
необязательный
Статус выполнения пункта. Возможные значения:
- Y — выполнен
- N — не выполнен
По умолчанию — N
IS_IMPORTANT
boolean
необязательный
Отметка, что пункт важный. Возможные значения:
- Y — важный
- N — обычный
MEMBERS
object
необязательный
Объект с описанием участников пункта чек-листа. Ключ — идентификатор пользователя, значение — объект с параметром типа участника TYPE. Возможные значения типа участника:
- 'TYPE': 'A' — соисполнитель
- 'TYPE': 'U' — наблюдатель
Система добавит участников пункта чек-листа в задачу в тех же ролях
PARENT_ID
integer
необязательный
Идентификатор родительского пункта. Используйте для вложенных чек-листов.
- Если передать
PARENT_IDсо значением0, система создаст в задаче новый чек-лист - Если в задаче нет пункта чек-листа с указанным
PARENT_ID, система создаст новый чек-лист - Если не указать
PARENT_IDвFIELDS, система добавит новый пункт в существующий верхний чек-лист. Если в задаче нет чек-листа, то создаст новый
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":13,"FIELDS":{"TITLE":"Подготовить отчет","PARENT_ID":457,"SORT_INDEX":200,"IS_COMPLETE":"N","IS_IMPORTANT":"Y","MEMBERS":{"547":{"TYPE":"A"}}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.checklistitem.add
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":13,"FIELDS":{"TITLE":"Подготовить отчет","PARENT_ID":457,"SORT_INDEX":200,"IS_COMPLETE":"N","IS_IMPORTANT":"Y","MEMBERS":{"547":{"TYPE":"A"}}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/task.checklistitem.add
// 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 ChecklistItemAddResult = number
try {
const response = await $b24.actions.v2.call.make<ChecklistItemAddResult>({
method: 'task.checklistitem.add',
params: {
TASKID: 13,
FIELDS: {
TITLE: 'Prepare the report',
PARENT_ID: 457,
SORT_INDEX: 200,
IS_COMPLETE: 'N',
IS_IMPORTANT: 'Y',
MEMBERS: {
547: {
TYPE: 'A',
},
},
},
},
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('Created checklist item with ID:', 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 addChecklistItem() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'task.checklistitem.add',
params: {
TASKID: 13,
FIELDS: {
TITLE: 'Prepare the report',
PARENT_ID: 457,
SORT_INDEX: 200,
IS_COMPLETE: 'N',
IS_IMPORTANT: 'Y',
MEMBERS: {
547: {
TYPE: 'A',
},
},
},
},
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('Created checklist item with ID:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', addChecklistItem)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
fields = {
"TITLE": "Подготовить отчет",
"PARENT_ID": 457,
"SORT_INDEX": 200,
"IS_COMPLETE": "N",
"IS_IMPORTANT": "Y",
"MEMBERS": {
"547": {
"TYPE": "A",
},
},
}
try:
bitrix_response = client.task.checklistitem.add(
task_id=13,
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.add',
[
'TASKID' => 13,
'FIELDS' => [
'TITLE' => 'Подготовить отчет',
'PARENT_ID' => 457,
'SORT_INDEX' => 200,
'IS_COMPLETE' => 'N',
'IS_IMPORTANT' => 'Y',
'MEMBERS' => [
547 => [
'TYPE' => 'A'
]
]
]
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error adding checklist item: ' . $e->getMessage();
}
BX24.callMethod(
'task.checklistitem.add',
{
'TASKID': 13,
'FIELDS': {
'TITLE': 'Подготовить отчет',
'PARENT_ID': 457,
'SORT_INDEX': 200,
'IS_COMPLETE': 'N',
'IS_IMPORTANT': 'Y',
'MEMBERS': {
547: {
'TYPE': 'A'
}
}
}
},
function(result){
console.info(result.data());
console.log(result);
}
);
require_once('crest.php');
$result = CRest::call(
'task.checklistitem.add',
[
'TASKID' => 13,
'FIELDS' => [
'TITLE' => 'Подготовить отчет',
'PARENT_ID' => 457,
'SORT_INDEX' => 200,
'IS_COMPLETE' => 'N',
'IS_IMPORTANT' => 'Y',
'MEMBERS' => [
547 => [
'TYPE' => 'A'
]
]
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "task.checklistitem.add", b24.Params{
"TASKID": 13,
"FIELDS": b24.Params{
"TITLE": "Подготовить отчет",
"PARENT_ID": 457,
"SORT_INDEX": 200,
"IS_COMPLETE": "N",
"IS_IMPORTANT": "Y",
"MEMBERS": b24.Params{
"547": b24.Params{
"TYPE": "A",
},
},
},
})
if err != nil {
return fmt.Errorf("task.checklistitem.add: %w", err)
}
var newID b24.ID
if err := json.Unmarshal(res.Result, &newID); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("идентификатор:", newID)
Ответ
HTTP-статус: 200
{
"result": 475,
"time": {
"start": 1762431907,
"finish": 1762431908.259832,
"duration": 1.2598319053649902,
"processing": 0,
"date_start": "2025-11-06T15:25:07+03:00",
"date_finish": "2025-11-06T15:25:08+03:00",
"operating_reset_at": 1762432508,
"operating": 0.24803590774536133
}
}
Возвращаемые данные
result
integer
Идентификатор нового пункта чек-листа
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error":"ERROR_CORE",
"error_description":"TASKS_ERROR_EXCEPTION_#8; Добавление элемента: действие недоступно; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E"
}
| Код | Описание | Значение |
|---|---|---|
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#8; Добавление элемента: действие недоступно; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E | Нет доступа к задаче или недостаточно прав, чтобы работать с чек-листами в задаче |
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskchecklistitem::add() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS | Не передан обязательный параметр TASKID или указан неверный тип значения для TASKID |
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#256; Param #1 (arFields) expected by method ctaskchecklistitem::add(), but not given.; 256\/TE\/WRONG_ARGUMENTS\u003Cbr\u003E | Не передан обязательный параметр FIELDS или передан пустой |
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#8; Не указано название элемента; 8\/TE\/ACTION_FAILED_TO_BE_PROCESSED\u003Cbr\u003E | Не передано обязательное поле TITLE в параметре FIELDS |

