hornet icon

hornet

Interact with hornet API

Actions452

Auditing → Auditing Export Post

AI-generated

Summary

Send a request to export auditing data filtered by various parameters and receive the results either as a direct download or via email.

Inputs

  • Object Id (required) — The ID of an object, which may be a user, customer, or partner, to filter the audit export.
  • APP ID (required) — Unique identifier specific to your app issued by Hornet Security, sent as a request header for authentication.
  • Export Type (required) — Defines how the export will be provided: either 'download' for immediate retrieval or 'email' to send the export by email.
  • Date From (required) — The start date and time (ISO-8601 UTC format) for filtering audit logs; must be earlier than 'Date To'.
  • Date To (required) — The end date and time (ISO-8601 UTC format) for filtering audit logs; if set in the future, it defaults to the current date and time.
  • User — The user responsible for the action, to filter audit entries.
  • Entity — Legacy field representing the module or entity that was changed.
  • Entity List — A JSON array specifying multiple entities to filter audit records.
  • Action — Legacy field specifying the action performed on the entity.
  • Action List — A JSON array specifying multiple actions to filter audit records.
  • Target — The target on which the user performed an action.
  • Target Path — The path of the target resource.
  • New Values — A JSON string containing the values after the change.
  • Old Values — A JSON string containing the values before the change.
  • App Id — Deprecated field for the ID of the app that made the request.
  • App Version — Deprecated field for the version of the app that made the request.
  • Ip — The IP address of the user performing the action.
  • Url — The API URL responsible for the change.
  • Status — Status of the audit entry.
  • Product — A JSON array of products to filter audit entries.
  • Region — Region parameter for filtering.
  • Offset — Pagination offset for audit export results.
  • Limit — Maximum number of records to include in the export.
  • Query — Free-text query for filtering audit records.
  • Email — Email address to send the export to when 'Export Type' is set to 'email'.
  • Export Keys — JSON array of specific columns to include in the export.

Output shape

a JSON response from the Hornet Security auditing export API containing the requested export data or confirmation of email dispatch

The operation sends an HTTP POST request with query and body parameters; the required APP-ID header and object_id query parameter must be provided. The export_type controls if the export is downloaded directly or sent via email. Pagination via offset and limit is supported. The response format depends on the export_type and Hornet API behavior.

Examples

Example 1: Download audit export filtered by object_id and date range

Set 'Object Id', 'APP ID', 'Export Type' to 'download', 'Date From', and 'Date To'; optionally set filters like 'User' or 'Entity List'. The node returns audit export data directly.

Example 2: Email audit export report

Set 'Export Type' to 'email' and provide a valid 'Email' address along with other required filters. The export link or file will be sent to the specified email.

Links

Discussion