Настройки платформы

Только владелец или админ организации по сессии: ключу API недоступно. Выключатель, месячный потолок и автопополнение — целиком. Баланс уже ниже порога — пополнение запускается сразу.

Только по сессии кабинета, не по ключу API.

PUT /v1/workspaces/{ws}/platform/account

Настройки платформы

cURL

curl --request PUT \
  --url https://api.tungo.kz/v1/workspaces/{ws}/platform/account \
  --header 'Content-Type: application/json' \
  --cookie tungo.session_token= \
  --data '
{
  "enabled": true,
  "monthly_cap_tiyn": 5000000,
  "auto_reload": {
    "enabled": false,
    "threshold_tiyn": null,
    "amount_tiyn": null,
    "monthly_limit_tiyn": null
  }
}
'

200

{
  "enabled": true,
  "balance_tiyn": 123,
  "monthly_cap_tiyn": 123,
  "month": "2026-11-01",
  "auto_reload": {
    "enabled": true,
    "threshold_tiyn": 123,
    "amount_tiyn": 123,
    "monthly_limit_tiyn": 123
  },
  "spent_tiyn": 123,
  "blocked_reason": "disabled",
  "purchase_limits": {
    "min_tiyn": 123,
    "max_tiyn": 123,
    "daily_max_tiyn": 123
  },
  "auto_reload_spent_tiyn": 123
}

Авторизации

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

Тело

application/json

Настройки платформы — целиком.

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

Выключатель платформы: false — вызовы по ключам и автоматизации останавливаются

monthly_cap_tiyn · integer | null · обязательно

Потолок трат платформы за календарный месяц по Алматы, в тиынах (1 ₸ = 100 тиын). null — без потолка

Требуемый диапазон: x >= 0

Пример:

5000000

auto_reload · object

Автопополнение баланса с карты организации. Не передано — выключено

Show child attributes

Ответ

200

application/json

Счёт

Счёт платформы для разработчиков: баланс, настройки и траты месяца; ключу на часть компаний — только баланс и потолок. С чатом не пересекается.

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

Выключатель платформы: false — вызовы по ключам и автоматизации останавливаются (402 platform_disabled)

balance_tiyn · integer · обязательно

Баланс платформы в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)

monthly_cap_tiyn · integer | null · обязательно

Месячный потолок трат в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸); null — без потолка

month · string · обязательно

Месяц по Алматы — его первое число, ГГГГ-ММ-ДД (календарная дата, без пояса — не переводить)

Пример:

"2026-11-01"

auto_reload · object

Автопополнение баланса платформы.

Show child attributes

spent_tiyn · integer

Траты платформы за этот месяц. Нет у ключа на часть компаний в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)

blocked_reason · enum<string> | null

Почему вызовы сейчас не пройдут: disabled — платформа выключена, cap — достигнут месячный потолок, balance — баланс закончился; null — всё в порядке. Нет у ключа на часть компаний

Доступные опции: disabled, cap, balance, null

purchase_limits · object

Границы суммы пополнения. Нет у ключа на часть компаний

Show child attributes

auto_reload_spent_tiyn · integer

Сколько автопополнение списало за этот месяц. Нет у ключа на часть компаний в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)