---
title: "Read immutable twelve-month activity with current owner permissions"
method: GET
path: "/v1/workspace/audit"
---

# Read immutable twelve-month activity with current owner permissions

`GET /v1/workspace/audit`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/workspace/audit`
- Auth: API key in header `Authorization`

## Query parameters

- `project_id` string
- `actor_account_id` string
- `cursor` string
- `kind` 'Sign-in' | 'Access' | 'Spending' | 'Exports' | 'Automation' | 'Lists'
- `limit` integer

## Response `200`

Authorized activity page

- object
  - `data` WorkspaceAuditPage, required
    - `events` WorkspaceAuditEvent[], required
      - `id` string, required
      - `at` string, required
      - `who` string, required
      - `actor_account_id` string, nullable, required
      - `actor_key_id` string, nullable, required
      - `project_id` string, nullable, required
      - `kind` 'Sign-in' | 'Access' | 'Spending' | 'Exports' | 'Automation' | 'Lists', required
      - `what` string, required
      - `action` string, required
      - `target_type` string, required
      - `target_id` string, required
    - `next_cursor` string, nullable, required
    - `retention_months` 12

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)