---
title: "List shadow-mode prompt-capture scopes (platform admin)"
method: GET
path: "/v1/admin/inference/shadow-capture"
tags: ["Internal"]
---

# List shadow-mode prompt-capture scopes (platform admin)

`GET /v1/admin/inference/shadow-capture`

Every scope currently on the config table, including a stale one an operator forgot to disable (still visible here; expiresAt tells the operator whether the gateway is still honoring it, an expired-but-not- yet-swept row is inert even though it's still listed).

## Response `200`

Active + recent scopes

- ShadowCaptureScopeList
  - `items` ShadowCaptureScope[], required
    - `allowAllOrgs` boolean — Required (true) for a scope whose orgId is "*"; ignored otherwise
    - `captureResponse` boolean, required — Also mirror the response payload (unary: scrubbed body; streaming: usage + timing only, see the gateway's capture-point limitation note). false captures the request + metadata only.
    - `createdAt` string
    - `createdBy` string
    - `enabled` boolean, required
    - `expiresAt` string, required — RFC3339 UTC; the scope self-expires here regardless of the DynamoDB TTL sweep timing. Mandatory: a capture toggle that outlives its purpose is a privacy incident.
    - `modelId` string, required — Public catalog model this scope governs, or "*" for every model
    - `note` string — Free-text operator note, e.g. what dataset this scope is for
    - `orgId` string, required — Org this scope governs, or "*" for every org (requires allowAllOrgs)
    - `sampleRate` number, double, required — Fraction of matching requests captured: 0 captures nothing, 1 captures every match
    - `updatedAt` string

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope
- `503` — A required integration (e.g. payments) is not configured

---

[API](https://skmtc.net/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.net/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/revisions/d728989c2568/schema)