task.commentitem.update
Обновить комментарий
Описание
Метод task.commentitem.update обновляет комментарий.
Параметры
TASKID
integer
обязательный
Идентификатор задачи.
Идентификатор задачи можно получить при создании новой задачи или методом получения списка задач
ITEMID
integer
обязательный
Идентификатор комментария.
Идентификатор комментария можно получить при добавлении нового комментария или методом получения списка комментариев
FIELDS
object
обязательный
Объект с полями комментария
Параметр FIELDS
POST_MESSAGE
string
обязательный
Текст сообщения
UF_FORUM_MESSAGE_DOC
array
необязательный
Массив с идентификаторами файлов с Диска. Перед каждым идентификатором укажите префикс n, например ['n123', 'n456', ... ].
У автора комментария должен быть доступ к прикрепляемым файлам, иначе метод вернет ошибку.
Поле перезаписывается полностью. Чтобы добавить файл к уже загруженным, передайте в массиве идентификаторы всех файлов — как старых, так и новых
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":8017,"ITEMID":3167,"FIELDS":{"POST_MESSAGE":"Комментарий обновлен","UF_FORUM_MESSAGE_DOC":["n4755"]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/task.commentitem.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"TASKID":8017,"ITEMID":3167,"FIELDS":{"POST_MESSAGE":"Комментарий обновлен","UF_FORUM_MESSAGE_DOC":["n4755"]},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/task.commentitem.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 UpdateCommentResult = boolean
try {
const response = await $b24.actions.v2.call.make<UpdateCommentResult>({
method: 'task.commentitem.update',
params: {
TASKID: 8017,
ITEMID: 3167,
FIELDS: {
POST_MESSAGE: 'Comment updated',
UF_FORUM_MESSAGE_DOC: ['n4755'],
},
},
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('Comment updated successfully:', 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 updateTaskComment() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'task.commentitem.update',
params: {
TASKID: 8017,
ITEMID: 3167,
FIELDS: {
POST_MESSAGE: 'Comment updated',
UF_FORUM_MESSAGE_DOC: ['n4755'],
},
},
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('Comment updated successfully:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateTaskComment)
</script>
try {
$response = $b24Service
->core
->call(
'task.commentitem.update',
[
'TASKID' => 8017,
'ITEMID' => 3167,
'FIELDS' => [
'POST_MESSAGE' => 'Комментарий обновлен',
'UF_FORUM_MESSAGE_DOC' => ['n4755'],
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
// Нужная вам логика обработки данных
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating task comment: ' . $e->getMessage();
}
BX24.callMethod(
'task.commentitem.update',
{
"TASKID": 8017,
"ITEMID": 3167,
"FIELDS": {
"POST_MESSAGE": "Комментарий обновлен",
"UF_FORUM_MESSAGE_DOC": ["n4755"]
}
},
function(result){
console.info(result.data());
console.log(result);
}
);
require_once('crest.php');
$result = CRest::call(
'task.commentitem.update',
[
'TASKID' => 8017,
'ITEMID' => 3167,
'FIELDS' => [
'POST_MESSAGE' => 'Комментарий обновлен',
'UF_FORUM_MESSAGE_DOC' => ['n4755']
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "task.commentitem.update", b24.Params{
"TASKID": 8017,
"ITEMID": 3167,
"FIELDS": b24.Params{
"POST_MESSAGE": "Комментарий обновлен",
"UF_FORUM_MESSAGE_DOC": []string{"n4755"},
},
})
if err != nil {
return fmt.Errorf("task.commentitem.update: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1753338761.030934,
"finish": 1753338761.389114,
"duration": 0.35817980766296387,
"processing": 0.16595101356506348,
"date_start": "2025-07-24T09:32:41+03:00",
"date_finish": "2025-07-24T09:32:41+03:00",
"operating_reset_at": 1753339361,
"operating": 0.16593098640441895
}
}
Возвращаемые данные
result
boolean
Возвращает true если комментарий обновлен успешно
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error":"ERROR_CODE",
"error_description":"Не указан текст комментария.<br>"
}
| Код | Описание | Значение |
|---|---|---|
ERROR_CORE |
Не указан текст комментария. | Обязательный параметр POST_MESSAGE не передан или пустой |
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#4; Action is not allowed; 4/TE/ACTION_NOT_ALLOWED | Ошибка возвращается в следующих случаях: - Указан неверный порядок параметров в методе - Нет прав доступа к задаче - При попытке обновить комментарий другого пользователя - Если указанной задачи или комментария не существует |
ERROR_CORE |
TASKS_ERROR_EXCEPTION_#256; Param #0 (taskId) for method ctaskcommentitem::delete() expected to be of type "integer", but given something else.; 256/TE/WRONG_ARGUMENTS | Ошибка возвращается в следующих случаях: - Не указан обязательный параметр, например, TASKID- Указан неверный тип значения для параметра, например, для TASKID |

