Platform API reference

Platform API · Workspace-Audit-Logs

get/v1/workspaces/{workspace_slug}/audit-feedAuth

Unified 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*string

Slug 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-time

ISO-8601 inclusive lower bound on `timestamp`. Items older than `since` are not returned.

untilstring · date-time

ISO-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.

actionstring

Exact-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 · uuid

Exact-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_onlyboolean

When `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`.

cursorstring

Opaque cursor from a previous response's `pagination.next_cursor`. Resumes the feed at the same merge boundary.

limitinteger

Per-page cap. Clamped to 1..500; default 100.

sourcesstring

Comma-separated subset of sources to include (e.g. `workspace_audit,heimdall_audit`). Omitted = all enabled sources.

Response · 200

data*array

One page of feed items, newest first.

pagination*object
next_cursor*string

Pass as `cursor` to get the next page; `null` on the last page.

Example: null

has_more*boolean

Whether another page follows this one.

Example: false

sources*array

Per-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_TOKEN

Response

{
  "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"
    }
  ]
}