метод REST scope: tasks

tasks.task.gantt.link.list

Получить список связей Ганта задачи

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

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод tasks.task.gantt.link.list возвращает список исходящих связей Ганта задачи. В ответе есть идентификатор связанной задачи и тип связи: Start-Start, Start-Finish, Finish-Start или Finish-Finish.

Метод не создает и не удаляет связи. Для создания связей используйте task.dependence.add, для удаления — task.dependence.delete.

Параметры

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

Фильтр для выбора связей Ганта задачи.

Передайте обязательное условие по полю taskId в формате ["taskId", 101].

Доступное поле фильтра:
- taskId — идентификатор задачи. Метод проверяет право на чтение этой задачи

select array необязательный

Массив полей, которые нужно вернуть.

Если параметр не передан, метод вернет все поля связи Ганта.

Доступные поля:
- taskId — идентификатор задачи
- dependentId — идентификатор задачи, с которой связана задача taskId
- type — тип связи Ганта
- creatorId — идентификатор пользователя, который создал связь

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

Объект для управления постраничной навигацией.

Параметры постраничной навигации:
- page — номер страницы. Если значение меньше единицы, используется первая страница
- limit — количество элементов на странице. По умолчанию 50, максимальное значение 1000
- offset — смещение от начала списка. По умолчанию 0

Если переданы page и offset, применяется смещение, рассчитанное по page.

Список сортируется по dependentId по возрастанию. Параметр order не поддерживается

Типы связей Ганта

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

Start-Start: начало задачи зависит от начала связанной задачи

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

Start-Finish: начало задачи зависит от завершения связанной задачи

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

Finish-Start: завершение задачи зависит от начала связанной задачи

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

Finish-Finish: завершение задачи зависит от завершения связанной задачи

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"filter":["taskId",101],"select":["taskId","dependentId","type","creatorId"],"pagination":{"limit":10,"offset":0}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.gantt.link.list

Ответ

HTTP-статус: 200

{
    "result": {
        "items": [
            {
                "taskId": 101,
                "dependentId": 205,
                "type": "finish_start",
                "creatorId": 1
            }
        ]
    },
    "time": {
        "start": 1787754442,
        "finish": 1787754442.612709,
        "duration": 0.6127090454101562,
        "processing": 0,
        "date_start": "2026-08-26T17:27:22+03:00",
        "date_finish": "2026-08-26T17:27:22+03:00",
        "operating_reset_at": 1787755042,
        "operating": 0
    }
}

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

result object

Объект с данными ответа (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "field": "filter",
                "message": "Значение поля не может быть пустым"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
filter Значение поля не может быть пустым Передайте фильтр ["taskId", 101], где 101 — идентификатор задачи
taskId В поле taskId требуется тип данных int для такого запроса Передайте taskId как число больше нуля
filter order Поле не поддерживает фильтрацию или сортировку В filter передайте только taskId. Не передавайте параметр order, порядок фиксирован

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

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