Until now, getting the audit log out of Hive Console meant exporting a CSV file from the organization settings. That works for an occasional review, but security teams want audit events in the same place as everything else: their SIEM.
The new audit log API makes that possible. It’s a single HTTP endpoint that your SIEM (Splunk, Microsoft Sentinel, Elastic, Datadog, …) or any script can poll to continuously ingest your organization’s audit log.
How It Works
- Cursor-based pagination: every response returns a
nextCursor. Store it, pass it back on the next request, and you’ll only receive events you haven’t seen yet. ALink: rel="next"header is included too, for clients that follow links. - Stable, versioned events: every event uses a versioned JSON envelope with the event type, the actor (user, organization access token or system), its IP address and user agent, and event-specific metadata.
- Filtering and backfill: use the
eventTypesquery parameter to only fetch the events you care about, and thesincequery parameter to choose how far back a new integration starts. Withoutsince, you get the full year of retained history.
For example, to only fetch sign-in events since November 1st:
Get Started
- In your organization Settings, create an
organization access token with the new
Describe audit log (
auditLog:describe) permission. - Point your SIEM’s HTTP pull input (or your own script) at
https://api.graphql-hive.com/audit-log/v1/eventsand send the token as a bearer token. - Fetch from the endpoint, following
nextCursorto retrieve latest events (until caught up; then poll every minute).