v1

latestOpenAPI 3.0.22026-07-24296786.1 KB
Audit Logs

Search audit log events (Advanced)

Advanced search endpoint for audit log events with complex filter criteria.

For most use cases, use GET /v2/auditLogs/events instead.

Use this endpoint when:

  • Filtering by 50+ actions or actors
  • Complex query logic (future enhancement)
  • Programmatic access requiring JSON request bodies

Exactly one of workspaceId or organizationId must be provided. Supports filtering by date range (Unix timestamps), multiple actions, multiple actor IDs, and target ID. Any combination of filters can be applied together.

Example request body for January 2024 user login events: { "workspaceId": "12345678-1234-1234-1234-123456789abc", "actions": ["user.authentication.login"], "startDate": 1704067200, "endDate": 1706745599 }

This endpoint is rate-limited and usage is tracked against your API quota.

post/v2/auditLogs/events/search

Request body

workspaceIdstring uuid nullable
organizationIdstring uuid nullable
startDateinteger nullable
endDateinteger nullable
actionsstring[] nullable
actorIdsstring[] nullable
targetIdstring nullable
cursorstring nullable
limitinteger

Response

Paginated list of audit events

nextCursorstring nullable

Opaque cursor for fetching the next page. Pass as cursor parameter.

hasMoreboolean required

Whether there are more events to fetch