Перейти к основному содержанию
PATCH
Поменять адрес

Авторизации

tungo.session_token
string
cookie
обязательно

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

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

ws
string
обязательно

id организации (workspace), ws_… — из GET /v1/workspaces

id
string
обязательно

id адреса вебхуков (ep_…)

Тело

application/json

Изменение адреса: меняются только переданные поля (хотя бы одно).

url
string

Адрес приёмника: только https и не во внутренней сети (localhost, 10.x, 192.168.x… — проверяется и по DNS), до 2000 знаков

Required string length: 1 - 2000
Пример:

"https://example.com/tungo/webhooks"

description
string

Подпись адреса для людей (до 500 знаков)

Maximum string length: 500
Пример:

"Учётная система"

event_types
string[] | null

Какие события слать на адрес — имена из GET …/webhooks/event-types (до 50). null или не передано при заведении — все события

Maximum array length: 50
Required string length: 1 - 100
Пример:
channels
string[] | null

Каналы — id сценариев автоматизаций (scn_…, до 10). Заданы — на адрес приходят только события этих сценариев (automation.run.completed, automation.run.failed, automation.run.notice, automation.write_unknown), и никаких других: так итог конкретного сценария идёт в свою систему. null или не передано при заведении — все события (по event_types)

Maximum array length: 10
Pattern: ^scn_[0-9a-z]{26}$
Пример:
enabled
boolean

false — не слать на адрес, пока не включат снова. При заведении по умолчанию — включён

Ответ

Адрес

Адрес вебхуков: сервер клиента, куда Tungo шлёт события организации.

id
string
обязательно

id адреса (ep_…) — для адресов …/webhooks/endpoints/{id}

Пример:

"ep_2xyzExample"

url
string
обязательно

Куда слать события (https)

Пример:

"https://example.com/tungo/webhooks"

description
string
обязательно

Подпись адреса для людей; пустая строка — не задана

event_types
string[] | null
обязательно

Какие события слать (имена из …/webhooks/event-types); null — все

channels
string[] | null
обязательно

Каналы — id сценариев автоматизаций (scn_…): на адрес идут только события этих сценариев; null — все события

enabled
boolean
обязательно

false — на адрес сейчас не шлётся ничего, пока не включат снова (PATCH enabled: true)

created_at
string<date-time>
обязательно

Когда заведён, ISO 8601 UTC

Пример:

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

updated_at
string<date-time>
обязательно

Когда менялся последний раз, ISO 8601 UTC

Пример:

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