Структура события

Поля события

Каждое событие содержит следующие поля:

• id — уникальный идентификатор события.
• occurredAt — время события в формате RFC 3339.
• action — сведения о действии, зафиксированном в журнале аудита.
  • type — тип действия, например workspace_create или user_sign_in. Список типов приведён в разделе «Типы действий».
  • details — дополнительные данные о действии. Набор полей зависит от типа действия.
• actor — сведения о том, кто выполнил действие.
  • type — показывает, кем выполнено действие: пользователем (user), анонимным пользователем (anonymous), системой (system) или неизвестным инициатором (unknown).
  • id — идентификатор.
  • name — имя, если доступно.
  • email — электронная почта, если доступна.
• context — данные о запросе, связанном с событием. Для системных событий поля могут отсутствовать.
  • requestId — идентификатор запроса.
  • sessionId — идентификатор сессии.
  • requestIp — IP-адрес источника запроса.
• scope — указывает организацию, рабочее пространство и канал, к которым относится событие. Любое из полей может отсутствовать.
  • organizationId — идентификатор организации.
  • workspaceId — идентификатор рабочего пространства.
  • workspaceName — название рабочего пространства.
  • channelId — идентификатор канала.
• entity — объект, затронутый действием.
  • type — тип объекта, определяющий набор остальных полей. Возможные значения перечислены в разделе «Типы объектов».
  • subtype — уточняющий тип объекта, если применимо.
  • id — идентификатор объекта.
  • name — имя объекта.
  • email — электронная почта пользователя.

Пример события

{
  "id": "46b44beb-b585-4598-a241-6bacea128799",
  "occurredAt": "2026-08-31T09:20:35.213Z",
  "action": {
    "type": "workspace_create",
    "details": {
      "fields": {
        "name": "Маркетинг"
      }
    }
  },
  "actor": {
    "type": "user",
    "id": "87736cf6-ca84-4519-8fc2-81c815b76c63",
    "name": "Иван Петров",
    "email": "ivan@example.com"
  },
  "context": {
    "requestId": "4f7f8a01-3a71-42f9-b7b2-71dca2cb55c8",
    "sessionId": "c192570a-3c98-464f-9e78-0cee7fddc864",
    "requestIp": "203.0.113.10"
  },
  "scope": {
    "organizationId": "d311fcba-32ba-417c-aabb-221a819f2ea4",
    "workspaceId": "069018a1-f7ae-42f7-adc7-d6684364abca",
    "workspaceName": "Маркетинг"
  },
  "entity": {
    "type": "workspace",
    "id": "069018a1-f7ae-42f7-adc7-d6684364abca",
    "name": "Маркетинг"
  }
}

Типы объектов

Поле entity.type указывает тип объекта:

Типы действий

Тип действия указан в поле action.type.

Каналы

Рабочие пространства

Организации

Пользователи и токены доступа

Лицензии