Skip to navigation

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.

Authentication

Authorizationstring
API Key authentication via header

Request

This endpoint expects an object.
workspaceIdstring or nullOptionalformat: "uuid"
organizationIdstring or nullOptionalformat: "uuid"
startDateinteger or nullOptional>=0
endDateinteger or nullOptional>=0
actionslist of strings or nullOptional
actorIdslist of strings or nullOptional
targetIdstring or nullOptional
cursorstring or nullOptional
limitintegerOptional1-200Defaults to 50

Response

Paginated list of audit events
eventslist of objects
List of audit log events
hasMoreboolean
Whether there are more events to fetch
nextCursorstring or nullOptional
Opaque cursor for fetching the next page. Pass as cursor parameter.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error