Audit log
The audit log records who created, changed and deleted what in your workspace, and every change to your organization's members, roles, teams and sign-in settings. List events, open one to see each field's value before and after, or read one record's whole history. You can also export the events that match your filters as CSV or JSON, and read or change how long events are kept. See Audit log.
List audit events
Who changed what, and when: every create, update and delete on this workspace's data, plus the organization's governance changes (roles, memberships, teams, SSO), newest first. Each row carries the per-field before/after diff inline (changes) and the resolved actor. The read is bounded to an event-time window — the last 90 days unless from/to are given — echoed back as windowFrom/windowTo; page with cursor. Events appear within about two minutes of the change.
path Parameters
workspaceIdWorkspace UUID
query Parameters
fromStart of the event-time window, ISO-8601. Default: 90 days before to.
toEnd of the event-time window, ISO-8601. Default: now.
actorUserId^([0-9a-fA-F]{8}-[0-…Only changes made by this user (UUID).
actorKindOnly changes by this kind of caller: browser = a person signed in themselves, agent = a coding session, local_agent = a person's own Productmind agent, mcp_client = another coding agent a person connected, service = a machine caller, impersonated = a service acting for a user, support = a Productmind Architect through a support grant.
entityTypeOnly changes to this entity type (registry key), e.g. task, feature, workspace_membership.
entityId^([0-9a-fA-F]{8}-[0-…Only changes to this entity (UUID); pair with entityType.
actionOnly this action, e.g. create, update, delete, or access (a recorded read).
phaseOnly this phase: completed (every ordinary change), or attempted / failed (the write-ahead bracket of a destructive operation).
operationIdOnly the events of one operation (operationId of a row): its other phases and, for a bulk operation, its sibling subjects.
qFree-text search: a case-insensitive substring of the entity's label, or its whole display id (e.g. TASK-12, any case).
cursorThe cursor from the previous page's response; omit for the first page.
limitPage size, 1–200 (default 50).
List audit events › Responses
A page of audit events
Pass back as cursor for the next page; null on the last page.
The Athena execution the page came from (result reuse); null for the local store.
windowFromThe event-time window the read was bounded to, ISO-8601 — 90 days ending at to unless from was given.
windowToGet one audit event
One audit event with its full diff and its related rows — the other phases of the same operation (an attempted beside its completed or failed) and the sibling subjects of a bulk operation. Pass at (the event's time, from a list row) so the store finds it in one pruned read; without it, an event older than the default 90-day window costs a second, unbounded read.
path Parameters
workspaceIdWorkspace UUID
eventId^([0-9a-fA-F]{8}-[0-… · requiredThe event id (id of a list row).
query Parameters
atThe event's time, ISO-8601, as a lookup hint — narrows the read to ±1 day around it.
Get one audit event › Responses
The audit event
List one entity's audit history
Every recorded change to one entity — a task, a feature, a membership — newest first, with the per-field diff of each. Not bounded to a window: the entity's whole history within the workspace's retention.
path Parameters
workspaceIdWorkspace UUID
entityTypeThe audited entity type, e.g. task, feature, bug_report, workspace_membership.
entityId^([0-9a-fA-F]{8}-[0-… · requiredThe entity's UUID.
query Parameters
limitMaximum number of events to return, newest first (1–200, default 100).
List one entity's audit history › Responses
The entity's events
Start a CSV or JSON export of the audit log
Starts an export of every event matching the filters. Poll GET /audit-logs/exports/{executionId} for the download URL.
path Parameters
workspaceIdWorkspace UUID
Start a CSV or JSON export of the audit log › Request Body
formatcsv = one file, columns in wire order; json = newline-delimited wire records (several parts for a large window).
The same filters as the list endpoint; the export covers every matching event, not one page.
Start a CSV or JSON export of the audit log › Responses
Export started
Poll an audit export
The export's status; when succeeded, a download URL valid for about an hour (re-issued on every poll).
path Parameters
workspaceIdWorkspace UUID
executionId^([0-9a-fA-F]{8}-[0-… · requiredThe export's execution id.
Poll an audit export › Responses
Export status
Download a finished audit export
Streams the file when the export was produced by the local store; redirects to the presigned URL otherwise.
path Parameters
workspaceIdWorkspace UUID
executionId^([0-9a-fA-F]{8}-[0-… · requiredThe export's execution id.
Download a finished audit export › Responses
The export file
Get the audit log's retention setting
path Parameters
workspaceIdWorkspace UUID
Get the audit log's retention setting › Responses
The setting
Set the audit log's retention
Days of audit history to keep (30–3650), or null for indefinite. Owner/admin only (audit-log:manage).
path Parameters
workspaceIdWorkspace UUID
Set the audit log's retention › Request Body
Days of audit history to keep, 30–3650; null keeps events indefinitely.
Set the audit log's retention › Responses
The setting