API: Audit Logs

Záznamy z Audit Logs si môžete čítať cez API, napríklad na archiváciu alebo do SIEM systému. API záznamy len číta, nič nemení.

Kľúč

Potrebujete API kľúč typu Audit Logs (len čítanie). Nie je viazaný na priečinok ani asistenta. Kľúč typu Audit nevie posielať dokumenty ani klásť otázky a iné kľúče nevedia čítať Audit Logs.

`GET /api/v1/audit-events`

curl "https://<vasa-instancia>/api/v1/audit-events?since=2026-09-01T00:00:00Z&limit=200" \
  -H "Authorization: Bearer kw_live_…"

Parametre

Parameter	Popis
`since`	Iba záznamy od tohto času (ISO 8601). Na priebežné sťahovanie pošlite čas posledného záznamu, ktorý už máte.
`from`, `to`	Časový rozsah (ISO 8601).
`group`	Oblasť: `access`, `users`, `agents`, `content`, `auth`, `settings`.
`actor`	Id používateľa, ktorý zmenu urobil (`kwargs` = podpora kwargs).
`entity`	Iba záznamy o jednom objekte, v tvare `typ:id`, napr. `team:clx…` alebo `agent:obchodny`.
`q`	Text v názvoch (človek, agent, tím, priečinok, súbor).
`limit`	Počet záznamov na stranu, najviac 200 (predvolene 100).
`cursor`	Ďalšia strana: hodnota `nextCursor` z predchádzajúcej odpovede.

Záznamy sú zoradené od najnovšieho. API nikdy nevráti záznamy staršie ako doba uchovávania vašej inštancie (štandardne 60 dní).

Odpoveď

{
  "events": [
    {
      "id": "cm1…",
      "at": "2026-09-24T08:12:03.120Z",
      "action": "access.team-agent.add",
      "label": "Agent pridaný tímu",
      "group": "access",
      "actor": { "kind": "user", "id": "clu…", "label": "Jana Nováková", "email": "jana@firma.sk" },
      "entity": { "type": "team", "id": "clt…", "label": "Obchod" },
      "target": { "type": "agent", "id": "obchodny", "label": "Obchodný asistent" },
      "changes": null,
      "meta": null
    }
  ],
  "nextCursor": "cm0…",
  "windowDays": 60
}

action je stabilný kód, label je jeho slovenský popis.
changes obsahuje pri úpravách pôvodnú a novú hodnotu: { "role": { "from": "member", "to": "admin" } }.
meta obsahuje doplnkové údaje, napr. počet a názvy súborov alebo IP adresu pri prihlásení.
Zmeny, ktoré urobila podpora kwargs, majú actor.label = kwargs podpora a bez e-mailu.

Limit: 120 požiadaviek za minútu na kľúč. Samotné čítanie cez API sa do Aktivít nezapisuje.