метод REST scope: task

tasks.task.history.list

Получить историю задачи

Кто может выполнять: любой пользователь с доступом к задаче на чтение

Описание

Метод tasks.task.history.list получает историю изменений задачи.

Параметры

taskId integer обязательный

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

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

filter object необязательный

Фильтр по типу события в формате {FIELD: 'EVENT'}. Список возможных значений для FIELD описан ниже

order object необязательный

Объект для сортировки результата вида {"поле": "значение сортировки", ... }.

Направление сортировки может принимать значения:

  • asc — по возрастанию
  • desc — по убыванию

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

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"taskId":8137,"filter":{"FIELD":"COMMENT"},"order":{"createdDate":"ASC"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.history.list

Ответ

HTTP-статус: 200

{
    "result": {
        "list": [
            {
                "id": 16359,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "NEW",
                "value": {
                    "from": null,
                    "to": null
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16361,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "COMMENT",
                "value": {
                    "from": null,
                    "to": "3409"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16363,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "CHECKLIST_ITEM_CREATE",
                "value": {
                    "from": "",
                    "to": "Что сделать"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16365,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "CHECKLIST_ITEM_CREATE",
                "value": {
                    "from": "",
                    "to": "Связаться с клиентом"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16367,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "CHECKLIST_ITEM_CREATE",
                "value": {
                    "from": "",
                    "to": "Подготовить договор"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16369,
                "createdDate": "2025-09-25T14:09:45+03:00",
                "field": "CHECKLIST_ITEM_CREATE",
                "value": {
                    "from": "",
                    "to": "Подписать договор"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16371,
                "createdDate": "2025-09-25T14:09:57+03:00",
                "field": "AUDITORS",
                "value": {
                    "from": "",
                    "to": "547"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16375,
                "createdDate": "2025-09-25T14:09:57+03:00",
                "field": "COMMENT",
                "value": {
                    "from": null,
                    "to": "3411"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            },
            {
                "id": 16373,
                "createdDate": "2025-09-25T14:09:58+03:00",
                "field": "COMMENT",
                "value": {
                    "from": null,
                    "to": "3413"
                },
                "user": {
                    "id": 503,
                    "name": "Мария",
                    "lastName": "Иванова",
                    "secondName": "",
                    "login": "maria@mysite.ru"
                }
            }
        ],
    },
    "time": {
        "start": 1758798620,
        "finish": 1758798620.969019,
        "duration": 0.9690189361572266,
        "processing": 0,
        "date_start": "2025-09-25T14:10:20+03:00",
        "date_finish": "2025-09-25T14:10:20+03:00",
        "operating_reset_at": 1758799220,
        "operating": 0
    }
}

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

result object

Корневой элемент ответа. Содержит массив list, который содержит объекты с описанием событий в задаче.

Возвращает пустой массив "list":[], если задача не существует

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "Access denied. (internal error)"
}
Код Описание Значение
100 CTaskItem All parameters in the constructor must have real class type (internal error) Не указан обязательный параметр taskId
0 wrong task id (internal error) В параметре taskId указано значение неверного типа
0 Access denied. (internal error) У пользователя нет доступа к задаче

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.