Security

Журнал аудита событий

Что происходило в пространстве: входы и выходы, изменения ролей и настроек, действия с чатами, сотрудниками и ботами. Записи только читаются — изменить или удалить их нельзя ни через API, ни из интерфейса.

Метод доступен владельцу пространства на тарифе «Корпорация», остальным сотрудникам он отвечает 403. Само обращение к журналу тоже записывается в журнал — событием audit_events_accessed.

События приходят от новых к старым и отбираются фильтрами: период по start_time и end_time, вид события по event_key, инициатор по actor_id и actor_type. Без фильтров метод отдаёт все события пространства постранично.

get/audit_events

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/audit_events
  • Auth: HTTP bearer

Query parameters

start_timestring date-time
Example:2025-05-01T09:11:00.000Z

Начальная метка времени, включительно (ISO-8601). Смещение вида +03:00 учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, фильтр снимает — ответ придёт полным, без ошибки.

end_timestring date-time
Example:2025-05-02T09:11:00.000Z

Конечная метка времени, включительно (ISO-8601). Смещение вида +03:00 учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, фильтр снимает — ответ придёт полным, без ошибки.

event_key'user_login' | 'user_logout' | 'user_2fa_fail' | 'user_2fa_success' | 'user_2fa_disabled' | 'user_created' | 'user_deleted' | 'user_role_changed' | 'user_updated' | 'tag_created' | 'tag_deleted' | 'user_added_to_tag' | 'user_removed_from_tag' | 'chat_created' | 'chat_renamed' | 'chat_permission_changed' | 'user_chat_join' | 'user_chat_leave' | 'tag_added_to_chat' | 'tag_removed_from_chat' | 'message_updated' | 'message_deleted' | 'message_created' | 'reaction_created' | 'reaction_deleted' | 'thread_created' | 'access_token_created' | 'access_token_updated' | 'access_token_destroy' | 'kms_encrypt' | 'kms_decrypt' | 'audit_events_accessed' | 'company_chats_accessed' | 'company_bots_accessed' | 'dlp_violation_detected' | 'search_users_api' | 'search_chats_api' | 'search_messages_api' | 'bot_scopes_updated' | 'bot_webhook_settings_updated' | 'bot_token_recreated' | 'bot_deleted' | 'bot_oauth_client_updated' | 'oauth_authorization_granted' | 'oauth_authorization_revoked' | 'oauth_device_authorization_approved' | 'oauth_device_authorization_denied' | 'video_call_started' | 'video_call_finished' | 'video_call_recording_ready' | 'exchange_disabled'

Тип аудит-события

Фильтр по конкретному типу события

actor_idstring
Example:98765

Идентификатор пользователя, выполнившего действие

actor_typestring
Example:User

Тип актора

entity_idstring
Example:98765

Идентификатор затронутой сущности

entity_typestring
Example:User

Тип сущности

limitinteger
Example:1

Количество записей для возврата

cursorstring
Example:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Курсор для пагинации (из meta.paginate.next_page или meta.paginate.prev_page)

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "id": "a1b2c3d4-5e6f-7g8h-9i10-j11k12l13m14",
      "created_at": "2025-05-15T14:30:00.000Z",
      "entity_id": "98765",
      "entity_type": "User",
      "actor_id": "98765",
      "actor_type": "User",
      "ip_address": "192.168.1.100",
      "user_agent": "Pachca/3.60.0 (co.staply.pachca; build:15; iOS 18.5.0) Alamofire/5.0.0"
    }
  ],
  "meta": {
    "paginate": {
      "next_page": "eyJxZCO2MiwiZGlyIjomSNYjIn3",
      "prev_page": "eyJxZCO2MiwiZGlyIjoiYXNjIn0",
      "has_next": true
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.