Activity log

    Read your workspace's activity log with an API key. Enterprise workspaces only; the key needs the audit:read scope.

    1 endpoint

    List activity log entries

    GET/audit/events

    Read the workspace activity log: who did what, when, and how. Available on Enterprise workspaces only; any other plan is refused with a 403. The key must hold the audit:read scope (or audit:*) by name. A key with full access (*) or with no scopes does not count, so add audit:read when you create or edit the key. A key reads the parts of the log that its creator's role allows: owners and admins read everything, a billing admin reads billing only. Entries run newest first, and only as far back as your plan shows (the window field says how far). Names and email addresses are not included; entries carry ids.

    Query Parameters

    NameTypeRequiredDescription
    categorystringoptionalOne of access, keys, billing, workspace, testing, numbers or assistant. A category your key's creator may not read is a 403.
    actionstringoptionalOne action, e.g. test.created
    actorstringoptionalThe actor's id alone, with no type prefix: a user id or an API key id (e.g. abc, not api_key:abc)
    targetstringoptionalThe record acted on, as type:id, e.g. api_key:abc
    fromstringoptionalOldest time to include (ISO 8601 date or time). Never earlier than your plan's window
    tostringoptionalNewest time to include. A date alone means the whole of that day (UTC)
    limitnumberoptionalMaximum entries to return: 1 to 100, default 50
    cursorstringoptionalnextCursor from the previous response. Send the same filters and the response's window.from as from

    Request

    bash
    curl -H "x-api-key: YOUR_API_KEY" \
      "https://api.nopaque.co.uk/audit/events?category=testing&limit=50"

    Response

    json
    {
      "entries": [
        {
          "id": "c1f0a6a2-8d51-4a53-9c60-3f1d2b7e9a10",
          "action": "test.created",
          "category": "testing",
          "workspaceId": "ws_abc123",
          "actor": {
            "type": "user",
            "id": "user_123"
          },
          "via": "app",
          "target": {
            "type": "test",
            "id": "test_456"
          },
          "details": {
            "kind": "standard"
          },
          "startedAt": "2026-10-21T09: 30: 00.000Z",
          "finishedAt": "2026-10-21T09: 30: 00.000Z",
          "outcome": "success"
        }
      ],
      "nextCursor": "eyJrIjoiLi4uIn0",
      "window": {
        "days": 395,
        "from": "2025-09-21T00: 00: 00.000Z"
      },
      "windowApplied": false
    }