Перейти к содержимому

Запуск задания

POST
/tasks/{task_id}/execute
curl --request POST \
--url 'https://app.mybi.ru/api/v2/tasks/1/execute?token=<token>' \
--header 'Content-Type: application/json' \
--data '{ "start_date": "2026-04-15", "end_date": "2026-04-15" }'

Планирует запуск задания за указанный период (start_date, end_date). Возвращает execution_id — следить за ходом можно в списке запусков задания. Неверный период — 400, недостаточно прав — 403.

task_id
обязательный
integer
>= 1

Идентификатор задания

Пример

1

Тело запроса с параметрами периода

MIME-типapplication/json
object
start_date

Начальная дата периода, обязательна (принимается также как query-параметр)

string формат: date
end_date

Конечная дата периода, обязательна (принимается также как query-параметр)

string формат: date

Пример сгенерировано

{
"start_date": "2026-04-15",
"end_date": "2026-04-15"
}

Результат запуска задания

MIME-типapplication/json

Стандартный ответ

object
result

Результат операции

string
message

Сообщение операции

string
data
object
execution_id

Идентификатор запуска

integer

Пример сгенерировано

{
"result": "example",
"message": "example",
"data": {
"execution_id": 1
}
}

Неверно указаны параметры периода

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}

Ошибка авторизации

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}

Запуск задания запрещён

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}

Задание не найдено

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}

Идентификатор запуска не получен

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}