/v1/workspaces/{workspace_slug}/audit-feedAuthUnified workspace audit feed (cursor-paginated)
Audit timeline for workspace-scoped events — workspace, member, role, invite, service-activation, PAK and OAuth-consent mutations, plus successful sign-ins and completed password resets. Per-app Auth rows are NOT merged in: they live in another database with no cursor that spans both, and they are served by `GET /v1/apps/:appId/audit-logs` (paginated), `.../audit-logs/export` (streamed) and the per-app audit sink. The `sources` field reports that explicitly rather than implying a pending follow-up.
Path parameters
workspace_slug*stringSlug of the workspace. Platform routes name the workspace by slug, positionally in the SDK (`platform.workspaces.retrieve("acme")`); the product APIs bind `workspace_id` instead.
Query parameters
sincestring · date-timeISO-8601 inclusive lower bound on `timestamp`. Items older than `since` are not returned.
untilstring · date-timeISO-8601 inclusive upper bound on `timestamp`. Composes with `since`, `action`, `actor_id` and with the cursor. A bare date resolves to midnight UTC, so `until=2026-05-01` excludes that day’s later entries.
actionstringExact-match filter on the action identifier (e.g. `workspace.member.removed`). A partial string matches nothing. Mail, Waitlist, Social and Auth actions are reported under the product name (`mail.domain.verified`); the older internal spellings (`envoi.*`, `rally.*`, `agora.*`, `heimdall.*`) are still accepted here and match the same rows.
actor_idstring · uuidExact-match filter on the acting account UUID. Must be a well-formed UUID — anything else is a 400, not an empty page. System rows have a null actor and are excluded by this filter.
changes_onlybooleanWhen `true`, return only admin changes: reads (any action ending `.read`), successful sign-ins (`auth.signin.succeeded`) and MCP tool-call rows (`workspace.mcp_tool.*`) are left out. The same rows the dashboard stats count as admin changes. Composes with every other filter and with the cursor; pass it on every page. Any value other than `true` or `1` means `false`.
cursorstringOpaque cursor from a previous response's `pagination.next_cursor`. Resumes the feed at the same merge boundary.
limitintegerPer-page cap. Clamped to 1..500; default 100.
sourcesstringComma-separated subset of sources to include (e.g. `workspace_audit,heimdall_audit`). Omitted = all enabled sources.
Response · 200
data*arrayOne page of feed items, newest first.
pagination*objectnext_cursor*stringPass as `cursor` to get the next page; `null` on the last page.
Example: null
has_more*booleanWhether another page follows this one.
Example: false
sources*arrayPer-source diagnostics so the UI / customer can see which sources contributed to this page and which are stubbed pending the cross-service fanout.
Example
Request
GET https://api.platform-auth.productcraft.co/v1/workspaces/{workspace_slug}/audit-feed
Authorization: Bearer YOUR_TOKENResponse
{
"data": [
{
"source": "workspace_audit",
"timestamp": "2026-01-01T00:00:00.000Z",
"actor_id": "00000000-0000-0000-0000-000000000000",
"actor_type": "platform_user",
"action": "mail.domain.verified",
"resource": "workspace_membership",
"resource_id": "00000000-0000-0000-0000-000000000000",
"metadata": {},
"source_ref": "4e5f5c9e-b4ee-4401-9275-283feb66c178"
}
],
"pagination": {
"next_cursor": null,
"has_more": false
},
"sources": [
{
"source": {},
"included": false,
"count": 0,
"error": "string"
}
]
}