v1

latestOpenAPI 3.0.22026-07-24296786.1 KB
Audit Logs

Query audit log events

Retrieve paginated audit log events for a workspace or an organization. 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.

Array parameters use comma-separated values:

  • Multiple actions: ?actions=billing.credits.consumed,dubbing.project.created
  • Multiple actors: ?actorIds=user-123,user-456

Example queries:

  • Latest events: GET /v2/auditLogs/events?workspaceId=12345678-1234-1234-1234-123456789abc&limit=50
  • Filtered by action and date: GET /v2/auditLogs/events?workspaceId=12345678-1234-1234-1234-123456789abc &actions=billing.credits.consumed&startDate=1704067200&endDate=1706745599
  • Multiple filters: GET /v2/auditLogs/events?workspaceId=12345678-1234-1234-1234-123456789abc &actions=billing.credits.consumed,dubbing.project.created&actorIds=user-123,user-456

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

get/v2/auditLogs/events

Query parameters

workspaceIdstring uuid

Workspace UUID to filter events by (mutually exclusive with organizationId)

organizationIdstring uuid

Organization UUID to filter events by (mutually exclusive with workspaceId)

actionsstring

Comma-separated list of actions to filter by (e.g. "billing.credits.consumed,dubbing.project.created")

actorIdsstring

Comma-separated list of actor IDs to filter by (e.g. "user-123,user-456")

targetIdstring

Filter events by target ID

startDateinteger

Filter events created on or after this Unix timestamp (seconds since epoch)

endDateinteger

Filter events created before this Unix timestamp (seconds since epoch)

cursorstring

Opaque cursor for pagination

limitinteger

Number of events per page (max 200)

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