Отменить запуск

curl --request POST \
  --url https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel \
  --cookie tungo.session_token=

import requests

url = "https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel"

headers = {"cookie": "tungo.session_token="}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "run_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "scenario_id": "scn_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "trigger": "hook",
  "trial": true,
  "event_id": "hev_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "external_id": "ORD-77",
  "event_type": "esf.incoming.received",
  "slot_at": "2026-10-05T09:30:00.000Z",
  "requested_by": "<string>",
  "state": "queued",
  "attempt": 123,
  "created_at": "2026-10-05T09:30:00.000Z",
  "started_at": "2026-10-05T09:30:00.000Z",
  "finished_at": "2026-10-05T09:30:00.000Z",
  "stop_reason": "<string>",
  "answer": "<string>",
  "output": {
    "order_id": "1532",
    "amount_tiyn": 4500000,
    "status": "written"
  },
  "output_error": "not_returned",
  "output_note": "<string>",
  "steps": [
    {
      "step": 123,
      "action": "agent",
      "state": "done",
      "answer": "<string>",
      "error": "<string>",
      "error_code": "<string>",
      "stop_reason": "<string>",
      "proposals": [
        "<string>"
      ],
      "findings": 123,
      "skipped_by": "always",
      "output": {},
      "output_error": "not_returned",
      "output_note": "<string>"
    }
  ],
  "current_step": 123,
  "tools": [
    "<string>"
  ],
  "proposals": [
    {
      "id": "<string>",
      "attempt": 123,
      "auto": "approved",
      "reason": "<string>",
      "code": "status",
      "batch": true,
      "duplicate_of": "<string>"
    }
  ],
  "error": "<string>",
  "error_code": "onec_offline",
  "retry_at": "2026-10-05T09:30:00.000Z",
  "auto_retries": 123,
  "cancel_requested": true,
  "retryable": true,
  "cost_tiyn": 123
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

Автоматизации

Отменить запуск

Ждущий в очереди (или ждущий автоповтора) запуск отменяется сразу (state: cancelled); идущий — останавливается на ближайшем шаге: до хода ИИ, между событиями хода, перед каждой записью в 1С (cancel_requested: true, затем state: cancelled). Уже записанное в 1С остаётся. Закрытый запуск — conflict_error (code wrong_state). Записывается в журнал аудита.

Доступ: automations.manage | company.manage.

Доступно по ключу API.

POST

companies

{co}

automations

runs

{id}

cancel

Отменить запуск

curl --request POST \
  --url https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel \
  --cookie tungo.session_token=

import requests

url = "https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel"

headers = {"cookie": "tungo.session_token="}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/automations/runs/{id}/cancel', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "run_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "scenario_id": "scn_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "trigger": "hook",
  "trial": true,
  "event_id": "hev_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "external_id": "ORD-77",
  "event_type": "esf.incoming.received",
  "slot_at": "2026-10-05T09:30:00.000Z",
  "requested_by": "<string>",
  "state": "queued",
  "attempt": 123,
  "created_at": "2026-10-05T09:30:00.000Z",
  "started_at": "2026-10-05T09:30:00.000Z",
  "finished_at": "2026-10-05T09:30:00.000Z",
  "stop_reason": "<string>",
  "answer": "<string>",
  "output": {
    "order_id": "1532",
    "amount_tiyn": 4500000,
    "status": "written"
  },
  "output_error": "not_returned",
  "output_note": "<string>",
  "steps": [
    {
      "step": 123,
      "action": "agent",
      "state": "done",
      "answer": "<string>",
      "error": "<string>",
      "error_code": "<string>",
      "stop_reason": "<string>",
      "proposals": [
        "<string>"
      ],
      "findings": 123,
      "skipped_by": "always",
      "output": {},
      "output_error": "not_returned",
      "output_note": "<string>"
    }
  ],
  "current_step": 123,
  "tools": [
    "<string>"
  ],
  "proposals": [
    {
      "id": "<string>",
      "attempt": 123,
      "auto": "approved",
      "reason": "<string>",
      "code": "status",
      "batch": true,
      "duplicate_of": "<string>"
    }
  ],
  "error": "<string>",
  "error_code": "onec_offline",
  "retry_at": "2026-10-05T09:30:00.000Z",
  "auto_retries": 123,
  "cancel_requested": true,
  "retryable": true,
  "cost_tiyn": 123
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

Авторизации

tungo.session_token

string

обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

string

обязательно

id компании, co_… — из GET /v1/companies

string

обязательно

id запуска (run_…)

Пример:

"run_01jz8x3m4n5p6q7r8s9t0v1w2x"

Ответ

Отмена принята

Запуск сценария — запись журнала автоматизаций.

string

обязательно

id запуска: подробности — GET …/automations/runs/{id}; повторить упавший — POST …/runs/{id}/retry (run_…)

Пример:

"run_01jz8x3m4n5p6q7r8s9t0v1w2x"

scenario_id

string

обязательно

Какой сценарий запущен (его могли удалить после запуска) (scn_…)

Пример:

"scn_01jz8x3m4n5p6q7r8s9t0v1w2x"

trigger

enum<string>

обязательно

Что запустило: hook — событие хука (event_id); event — событие внутри Tungo (event_type, event_id; external_id — id события evt_…, тот же, что у вебхука); schedule — расписание (slot_at); manual — ручной запуск (…/run); directbank — заход опроса выписки DirectBank (без ИИ: предложения выписки одобряются по правилу сценария с auto_approve.directbank)

Доступные опции:

hook,

schedule,

manual,

event,

directbank

trial

boolean

обязательно

true — пробный прогон: на прошлом событии (POST …/scenarios/{id}/run с event_id) или на пробном событии хука (POST …/hooks/{id}/test с run: true). В 1С само ничего не пишется даже при правиле автоодобрения — все предложения ждут человека; в ленте карточка с пометкой «Пробный прогон»

event_id

string | null

обязательно

Событие (hev_…), которое запустило: у хука — тот же event_id, что вернул приём POST /hooks/{token}; подробности — event у GET …/runs/{id}. null — запуск не по событию

Пример:

"hev_01jz8x3m4n5p6q7r8s9t0v1w2x"

external_id

string | null

обязательно

id этого события у отправителя (по id_path хука, Idempotency-Key, X-Event-Id или sha256 тела) — для сопоставления со своим заказом или платежом; у события Tungo — его id evt_… (тот же, что в вебхуке); у пробного события хука — trial:… (номер отправителя оно не занимает). null — запуск не по событию

Пример:

"ORD-77"

event_type

string | null

обязательно

Вид события Tungo, запустившего сценарий (trigger = event); null — запуск не по нему

Пример:

"esf.incoming.received"

slot_at

string<date-time> | null

обязательно

Плановое время запуска по расписанию, ISO 8601 UTC; null — запуск не по расписанию

Пример:

"2026-10-05T09:30:00.000Z"

requested_by

string | null

обязательно

Кто запросил запуск (usr_…) — при ручном запуске и повторе. null — запуск по хуку или расписанию: человека нет, смотрите trigger и run_as сценария

state

enum<string>

обязательно

Состояние: queued — ждёт очереди (у компании на паузе — до её снятия); running — идёт; done — завершён (итог — answer и proposals); error — не удался (почему — error; можно повторить, а при error_code = onec_offline он повторится сам в retry_at); skipped — не выполнялся: сценарий выключен или удалён к моменту запуска, либо на событие Tungo очередь компании была полна (почему — error); cancelled — отменён человеком (POST …/runs/{id}/cancel)

Доступные опции:

queued,

running,

done,

error,

skipped,

cancelled

attempt

integer

обязательно

Номер попытки: 1, каждый повтор (retry) прибавляет 1

created_at

string<date-time>

обязательно

Когда запуск поставлен в очередь, ISO 8601 UTC

Пример:

"2026-10-05T09:30:00.000Z"

started_at

string<date-time> | null

обязательно

Когда начался, ISO 8601 UTC; null — ещё не начался

Пример:

"2026-10-05T09:30:00.000Z"

finished_at

string<date-time> | null

обязательно

Когда закончился, ISO 8601 UTC; null — ещё не закончился

Пример:

"2026-10-05T09:30:00.000Z"

stop_reason

string | null

обязательно

Техническая причина остановки хода ИИ (например, end_turn — штатно). Для людей — answer и error. null — хода ИИ не было или он не закончился

answer

string | null

обязательно

Итоговый ответ ИИ — что сделано, текстом как в чате. null — ответа нет (ещё идёт, не удался или action: checks)

output

object | null

обязательно

Итог в форме сценария (output): поля — числа, да/нет, значения из списка и номера. Тот же итог — в вебхуке automation.run.completed. null — у сценария нет формы итога, ИИ итог не вернул или он не прошёл проверку (output_error)

Show child attributes

Пример:

{
  "order_id": "1532",
  "amount_tiyn": 4500000,
  "status": "written"
}

output_error

enum<string> | null

обязательно

Почему итога нет: not_returned — ИИ его не отдал; rejected — отдал не в заданной форме (например, имя в поле номера). Запуск при этом не падает. null — итог есть или формы нет

Доступные опции:

not_returned,

rejected,

null

output_note

string | null

обязательно

То же словами для человека; null — итог есть или формы нет

steps

object[]

обязательно

Итоги шагов запуска по порядку (у запусков до цепочек — пусто). Повтор упавшего запуска продолжает с упавшего шага, прошлые не повторяются

Show child attributes

current_step

integer | null

обязательно

Номер шага (с 1), на котором запуск идёт, упал или отменён — с него продолжит повтор; null — запуск закончен успешно или шаги ещё не начинались

tools

string[]

обязательно

Какие инструменты ИИ вызывал (технические имена) — для разбора запуска

proposals

object[]

обязательно

Предложения, подготовленные запуском (по всем попыткам)

Show child attributes

error

string | null

обязательно

Почему запуск не удался или пропущен — текст для человека; null — ошибки нет

error_code

string | null

обязательно

Машинная причина ошибки: onec_offline — 1С не была на связи (программа в офисе или сервер 1С); null — другая причина или ошибки нет

Пример:

"onec_offline"

retry_at

string<date-time> | null

обязательно

Когда запуск повторится сам (ISO 8601 UTC) — только при error_code = onec_offline, пока не кончились попытки настройки automations.retry; null — сам не повторится

Пример:

"2026-10-05T09:30:00.000Z"

auto_retries

integer

обязательно

Сколько раз запуск уже повторялся сам после «1С не на связи»

cancel_requested

boolean

обязательно

true — отмена запрошена, идущий запуск остановится на ближайшем шаге (state станет cancelled)

retryable

boolean

обязательно

true — запуск можно повторить (state = error): показать кнопку «Повторить» → POST …/runs/{id}/retry

cost_tiyn

integer

Стоимость запуска — расход ИИ с баланса платформы, в тиынах (1 ₸ = 100 тиын). 0 — ИИ не вызывался. Поле есть только у ключа API и у владельца и админа организации по сессии; остальным участникам его нет