latestOpenAPI 3.1.02026-08-223391355.6 KB

aa8d44585147

security-governance

Query workspace audit logs (Preview)

Plan: Enterprise

Returns workspace audit log entries newest first (event timestamp descending, event ID as the cursor tie-breaker), paginated via an opaque cursor. Pagination and total-count behavior may change before this operation graduates to the stable surface.

This operation is in public preview (beta) and served under /v1beta. Request and response shapes may change before it graduates to the stable /v1 surface.

get/v1beta/workspaces/{workspace_id}/audit-logs

Path parameters

workspace_idstring required

Workspace ID

Workspace ID

Query parameters

limitinteger

Maximum results per page.

Maximum results per page.

cursorstring

Opaque cursor returned by a previous page; omit for the first page.

Opaque cursor returned by a previous page; omit for the first page.

actionsstring

Comma-separated audit-log action filter (exact match, e.g. workspace.member.added).

Comma-separated audit-log action filter (exact match, e.g. workspace.member.added).

actor_idsstring

Comma-separated list of actor user IDs to filter by.

Comma-separated list of actor user IDs to filter by.

target_idsstring

Comma-separated list of target resource IDs to filter by.

Comma-separated list of target resource IDs to filter by.

searchstring

Token-based search on target_id and target_display_name. Minimum 3 characters.

Token-based search on target_id and target_display_name. Minimum 3 characters.

start_datestring

RFC3339 inclusive start of the time range. Defaults to 30 days ago. When paginating with cursor, pass an explicit start_date so the default lower bound does not drift between pages.

RFC3339 inclusive start of the time range. Defaults to 30 days ago. When paginating with cursor, pass an explicit start_date so the default lower bound does not drift between pages.

end_datestring

RFC3339 inclusive end of the time range. Defaults to now.

RFC3339 inclusive end of the time range. Defaults to now.

Response

OK