---
title: "Audit events of one run"
method: GET
path: "/v1/admin/runs/{run_id}/audit-events"
tags: ["admin"]
---

# Audit events of one run

`GET /v1/admin/runs/{run_id}/audit-events`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/runs/{run_id}/audit-events`
- Auth: HTTP bearer

The workspace audit events that name this run, newest first, recorded within 7 days of the run's start. `window_start` and `window_end` give that window. `complete` is false when the run went on past `window_end` or is still running, so later events can be missing. Each event has its action, target, risk tier, the person it is attributed to, its metadata and its time. A message action Patricia declined, such as a direct message she refused to send, is recorded here with its reason. The read is recorded against your staff account.

## Path parameters

- `run_id` string, uuid, required: The run id.

## Query parameters

- `limit` integer: How many rows to return, 1 to 200. Defaults to 50.
- `pq` string, nullable: The page marker from the `next` or `previous` value of an earlier answer.
- `from_prev` boolean: True when the page marker came from `previous`.

## Response `200`

Successful Response

- RunAuditEvents
  - `window_start` string, date-time, required
  - `window_end` string, date-time, required
  - `complete` boolean, required
  - `items` RunAuditEvent[], required
    - `id` string, uuid, required
    - `action` string, required
    - `target` string, nullable, required
    - `risk_tier_code` string, nullable, required
    - `actor` AdminActorRef, required
      - `id` string, uuid, required
      - `display_name` string, required
      - `unavailable` boolean
    - `metadata` object, required
    - `created_at` string, date-time, required
  - `first` string, required
  - `next` string, nullable, required
  - `previous` string, nullable, required

## Other responses

- `422`: Validation Error

---

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