метод REST scope: task

tasks.task.files.attach

Прикрепить файлы к задаче

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

Описание

Метод tasks.task.files.attach добавляет файл с Диска в задачу. У пользователя должен быть доступ к файлу на чтение или выше.

Параметры

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

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

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

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

Идентификатор файла на Диске.

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

Использовать один из методов загрузки файла:
- disk.storage.uploadfile
- disk.folder.uploadfile

Использовать один из методов получения списка файлов:
- disk.storage.getchildren
- disk.folder.getchildren

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"taskId":8017,"fileId":1065}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.files.attach

Ответ

HTTP-статус: 200

{
    "result": {
        "attachmentId": 1079
    },
    "time": {
        "start": 1758806783,
        "finish": 1758806783.609955,
        "duration": 0.6099550724029541,
        "processing": 0,
        "date_start": "2025-09-25T16:26:23+03:00",
        "date_finish": "2025-09-25T16:26:23+03:00",
        "operating_reset_at": 1758807383,
        "operating": 0.4156019687652588
    }
}

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

result object

Корневой элемент ответа. Содержит объект с описанием прикрепленного файла

attachmentId integer

Идентификатор прикрепления файла к задаче.

Получить данные о файле по идентификатору прикрепления можно методом disk.attachedObject.get

time time

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

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

HTTP-статус: 400

{
    "error": "100",
    "error_description": "Could not find value for parameter {fileId} (internal error)"
}
Код Описание Значение
100 CTaskItem All parameters in the constructor must have real class type (internal error) Не указан обязательный параметр taskId
0 wrong task id (internal error) В параметре taskId указано значение неверного типа
100 Could not find value for parameter \{fileId\} (internal error) Не указан обязательный параметр fileId
100 Invalid value {value} to match with parameter \{fileId\}. Should be value of type int. (internal error) В параметре fileId указано значение неверного типа
ERROR_CORE Недостаточно прав.\\u003Cbr\\u003E Нет доступа к указанному файлу
0 Access denied (internal error) Недостаточно прав на изменение задачи

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

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