Журнал действий организации

Владелец и админ по сессии или ключ API, чей создатель всё ещё владелец или админ организации. Ключу — только если он открыт на все действующие компании (иначе 403 audit_requires_all_companies); записи об архивных компаниях ему не видны, а имён, IP и подробностей (data) в ответе ключу нет: они только по сессии. От новых к старым, страницами: следующая — с ?cursor=next_cursor и теми же фильтрами.

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

GET /v1/workspaces/{ws}/platform/audit

Журнал действий организации

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/workspaces/{ws}/platform/audit \
  --cookie tungo.session_token=

200

{
  "data": [
    {
      "id": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x",
      "at": "2026-10-05T09:30:00.000Z",
      "actor": {
        "type": "user",
        "id": "<string>",
        "name": "<string>"
      },
      "action": "api_key.created",
      "action_title": "Выпущен ключ API",
      "company_id": "co_01jz8x3m4n5p6q7r8s9t0v1w2x",
      "target": {
        "type": "user",
        "id": "<string>"
      },
      "object": {
        "type": "webhook",
        "id": "<string>",
        "name": "https://example.kz/hooks/tungo",
        "amount_tiyn": 1500000,
        "purpose": "subscription"
      },
      "ip": "<string>",
      "request_id": "<string>",
      "data": "<unknown>"
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "total": 214,
  "total_more": true
}

Авторизации

sessionapiKeybearerKey

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

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

cursor · string

next_cursor прошлой страницы (aud_…); без него — самые свежие записи

limit · integer · по умолчанию: 50

Записей на странице, 1–200; по умолчанию 50

Требуемый диапазон: 1 <= x <= 200

action · string

Только действия, начинающиеся с этой строки: «workspace.member_» — все действия с сотрудниками, «api_key.created» — точное

Maximum string length: 100

Пример:

"workspace.member_"

from · string<date-time> | null

Записи не раньше этого момента, ISO 8601 (включительно). Нет — с самого начала

Пример:

"2026-10-01T00:00:00+05:00"

to · string<date-time> | null

Записи раньше этого момента, ISO 8601 (не включительно); позже from. Нет — до сейчас

Пример:

"2026-11-01T00:00:00+05:00"

api_key_id · string

Только действия, сделанные этим ключом API (key_…)

Maximum string length: 100

Пример:

"key_01h455vb4pex5vsknk084sn02q"

Ответ

200

application/json

Записи журнала

data · object[] · обязательно

Записи этой страницы, от новых к старым

Show child attributes

next_cursor · string | null · обязательно

Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор непрозрачный: не разбирать и не собирать самому, хранить только до следующего запроса. Пустой data с не-null курсором не бывает.

Пример:

"aud_01jz8x3m4n5p6q7r8s9t0v1w2x"

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

Сколько всего записей под этими фильтрами (курсор не учитывается). Считается не дальше 10 000: если записей больше — здесь 10 000 и total_more = true

Пример:

214

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

true — записей больше, чем total: писать «больше 10 000», а не точное число