---
title: "Cross-tenant Run ledger"
method: GET
path: "/v1/admin/runs"
tags: ["admin"]
---

# Cross-tenant Run ledger

`GET /v1/admin/runs`

## 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`
- Auth: HTTP bearer

List agent runs across workspaces, with filters for workspace, person, conversation, status, trigger, source, time, cost, and silent outcomes.

Returns `items` and paging information. Each item includes recorded tokens, cost, provenance, and outcome flags.

## Query parameters

- `team_id` string, uuid, nullable
- `actor_id` string, uuid, nullable
- `conversation_id` string, uuid, nullable
- `parent_run_id` string, uuid, nullable
- `status_code` 'queued' | 'running' | 'waiting_approval' | 'suspended' | 'completed' | 'failed' | 'cancelled' | 'denied_autonomous'
- `trigger_code` 'mention' | 'dm' | 'message' | 'proactive' | 'cron' | 'event' | 'heartbeat' | 'discovery' | 'onboarding' | 'manual' | 'spawn'
- `source_kind` 'task_cron' | 'event_trigger' | 'scheduled_program' | 'cued_proactive' | 'sweep_proactive' | 'onboarding' | 'manual' | 'spawn': What kind of durable thing caused a Class-A run, for ``AgentRun.source_kind``. The source is the JOB, PROGRAM, or EVENT, deliberately not the run and not the tool family. A daily cron is ONE source that fires ninety times, and the question Phase 1 has to answer ("how much would this source actually be asking a human?") is unanswerable if each fire looks like an unrelated run.
- `source_ref` string, nullable
- `model` string, nullable
- `cost_micro_usd_min` integer, nullable
- `cost_micro_usd_max` integer, nullable
- `duration_ms_min` integer, nullable
- `duration_ms_max` integer, nullable
- `started_after` string, date-time, nullable
- `started_before` string, date-time, nullable
- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable
- `truncated` boolean, nullable
- `no_result` boolean, nullable
- `silent` boolean, nullable
- `limit` integer
- `sort_by` 'created_at:desc' | 'created_at:asc'
- `pq` string, nullable
- `from_prev` boolean

## Response `200`

Successful Response

- AdminRunListResponse
  - `items` AdminRunListItem[], required
    - `id` string, uuid, required
    - `team` AdminTeamRef, required
      - `id` string, uuid, required
      - `display_name` string, required
      - `unavailable` boolean
    - `actor` AdminActorRef
      - `id` string, uuid, required
      - `display_name` string, required
      - `unavailable` boolean
    - `actor_email` string, nullable
    - `request_excerpt` string, nullable
    - `conversation` AdminConversationRef
      - `id` string, uuid, required
      - `title` string, required
      - `platform_code` string, required
      - `kind_code` string, required
      - `unavailable` boolean
    - `parent` AdminRunRef
      - `id` string, uuid, required
      - `status_code` string, required
      - `trigger_code` string, required
      - `started_at` string, date-time, nullable
      - `unavailable` boolean
    - `status_code` string, required
    - `trigger_code` string, required
    - `source_kind` string, nullable
    - `source_ref` string, nullable
    - `model` string, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_write_tokens` integer, required
    - `cost_micro_usd` integer, required
    - `duration_ms` integer, nullable
    - `truncated` boolean, required
    - `no_result` boolean, required
    - `silent` boolean, required
    - `pending_effect_at_close` boolean, required
    - `deferred_effect_status` string, nullable, required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `created_at` string, date-time, required
  - `first` string, nullable
  - `next` string, nullable
  - `previous` string, nullable

## 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)