# SportsDesk & Fantasy402 Wire API Reference

Evidence-labelled reference generated from `docs/openapi.json` (version `2026.10.31`) and `docs/evidence/ledger.json`. Do not edit this file by hand — run `bun run scripts/generate_docs.ts`.

## What is verified vs inferred

1. **Verified (tier B, 14 of 103 operations):** a captured request side or an implementation-verified route exists. **No response body was captured**, so no response shape here is a contract.
2. **Inferred (tier C, 29 operations):** authored in the spec, a repo type or a UI/DOM observation. No request or response was observed; treat these as proposals.
3. **Captured responses (tier A, 11) and recovered surfaces (tier D, 49):** tier A requires a captured response body and the count is above; tier D operations are real surfaces recovered from code or fixtures after being absent from the spec. No tier E operation remains in the spec — documented-but-unimplemented paths were removed.

Ledger totals across every recorded row (including rows removed from the final spec): A 11 · B 15 · C 29 · E 10 · surfaces D 20 / E 1. Full model: [docs/EVIDENCE.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/EVIDENCE.md).

## GSLive Manager (Partner 118): operator deep links

GSLive is a third-party operator console, **not** a server of this API. The links below are
deep links an operator opens in a browser; they carry no request contract of ours. Every
per-account link is produced by `lib/gslive_manager_deeplink_sidecar.ts` and can be generated
with `./bin/dx gslive <LOGIN>`.

| Surface                           | Route                  | What it answers                                                                        |
| :-------------------------------- | :--------------------- | :------------------------------------------------------------------------------------- |
| Account report (batch)            | `#/reports/users`      | Profit, bets, hold %, wager and leg counts for one `player_<LOGIN>` over a day window. |
| Live settling stream (`calcTime`) | `#/events/bet-history` | Tickets as they settle/populate for the current desk day.                              |
| Live placement stream (`betTime`) | `#/events/bet-history` | Tickets as they are placed.                                                            |

### Account report rules

- `bot=true` is mandatory. The SPA defaults the bot switch off, which hides syndicate accounts such as `player_CHURN_003` and `player_NOISE_BOT_77`.
- `from` and `to` must be explicit ISO-8601 UTC desk-day boundaries (`00:00:00` to `23:59:59` in `America/Chicago`). A bare `text=` search renders an empty grid.
- `searchBy=player` and `text=player_<LOGIN>`; `partnerId=118`.

Example (fixed churn window; the CLI emits today's rolling window):

```text
https://plive.sportswidgets.pro/manager-tools/#/reports/users?bot=true&eventId=&from=2026-10-18T05%3A00%3A00.000Z&partnerId=118&searchBy=player&text=player_CHURN_003&to=2026-10-26T04%3A59%3A59.000Z
```

### Live bet-history rules

- `from` and `to` are the desk-day start in **epoch seconds**; `toTime` is the offset to the last second of that day (`86399`, or `89999`/`82799` on US DST transition days).
- `minVolume=0` and `maxTimeUntilScore=0` disable volume/score-time filtering so live tickets appear immediately.
- `t` is an epoch-millisecond cache-buster and must be fresh on every open.
- `dateFilterBy=calcTime` follows settlement; `dateFilterBy=betTime` follows placement.
- `partnerUserId=<LOGIN>` (raw login, e.g. `AF12`) filters to one player; the live console emits the unprefixed form. It is **unverified** as a server-side filter — confirm by row count, and if the grid is not filtered, filter in the console.

```text
https://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=calcTime&t=1793469958152
https://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=betTime&t=1793469958152
```

Per-player variant (adds `partnerUserId`):

```text
https://plive.sportswidgets.pro/manager-tools/#/events/bet-history?minVolume=0&maxTimeUntilScore=0&from=1793422800&to=1793422800&toTime=86399&dateFilterBy=calcTime&t=1793469958152&partnerUserId=CHURN_003
```

### Related documentation

- `docs/gs-manager-contracts.md` — observed payloads and open questions.
- `docs/OPERATOR_QUICKSTART_AND_10_MODE_RUNBOOK.md` — which surface to use for Modes 1, 6, 7, 8, 9 and 10.

## Operational domains

| Domain / tag                       | Operations | Evidence tiers | Purpose                                                                                                                                                                        |
| ---------------------------------- | ---------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Forensic Surveillance              | 2          | A 1 · B 1      | Cloud Manager surveillance operations with first-party evidence; tier-A rows carry a live request+response capture.                                                            |
| Customer State Mutations           | 1          | A 1            | Cloud Manager customer state operations with first-party evidence; tier-A rows carry a live request+response capture.                                                          |
| Local Desk &amp; Telegram Gateway  | 58         | B 10 · D 48    | Routes served by sportsdesk_webview_server.ts, verified against the handler source rather than an HTTP capture.                                                                |
| Downline Accounting                | 3          | B 3            | Downline accounting reports (weekly figure, agent performance). The agent-performance request was observed on 2026-11-01; no response body has been captured for any of them.  |
| Settlement History                 | 1          | D 1            | Upstream settlement-history poll wired in code; the request contract and response rows are uncaptured.                                                                         |
| Inferred (Unverified)              | 29         | C 29           | Tier C operations: inferred or authored only. No request or response was ever observed; path and method are candidates, not contracts.                                         |
| Live-captured (request unverified) | 9          | A 9            | Tier-A operations whose path/method were previously inferred (tier C): the response is live-captured, while the request field template is not observed and remains unverified. |

## Headers matrix

### Outbound request headers

| Header             | Required    | Declared value                                                                   | Purpose                                                                                                   | Evidence                                                                                                                                                                                                                                                                                               |
| ------------------ | ----------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Authorization`    | yes         | `Bearer <token>`                                                                 | Bearer token used by the local daemon surface.                                                            | Declared for the local daemon (`daemonBearer`) and implementation-verified there (`services/sportsdesk_webview_server.ts:257-276`). The 2026-10-28 Manager HAR sent **no** Authorization header: the observed Manager session is cookie-based (`docs/runbooks/operational_guardrails_runbook.md:153`). |
| `Content-Type`     | conditional | `application/x-www-form-urlencoded` or `application/json` depending on operation | Payload serialization announced by the caller.                                                            | Observed on the `getWebLog` mode-B request as `application/x-www-form-urlencoded; charset=UTF-8` (`docs/runbooks/operational_guardrails_runbook.md:129-140`); other content types are spec declarations, not captures.                                                                                 |
| `Cookie`           | yes         | `session`                                                                        | Session cookie used by the cloud Manager surface.                                                         | Observed: the 2026-10-28 Manager HAR session is cookie-based (`docs/runbooks/operational_guardrails_runbook.md:153`). Cookie name, lifetime, renewal and scope were **not** captured.                                                                                                                  |
| `X-Requested-With` | yes         | string, example `XMLHttpRequest`                                                 | Observed on the captured 2026-10-28 mode-B Manager request. Whether the portal enforces it is unverified. | Observed on the `getWebLog` mode-B request (`XMLHttpRequest`, `docs/runbooks/operational_guardrails_runbook.md:129-140`).                                                                                                                                                                              |

### Inbound response security headers

| Header                    | Declared value                                                                     | Purpose                                                                                                                                                                                     | Evidence                                                                                                                                     |
| ------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `Content-Security-Policy` | `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:` | Content-Security-Policy applied to daemon responses: frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram: (services/sportsdesk_webview_server.ts, baseHeaders). | Implemented for local daemon responses (`services/sportsdesk_webview_server.ts:843-857`). Upstream cloud response headers were not captured. |
| `Referrer-Policy`         | `strict-origin-when-cross-origin`                                                  | Referrer-Policy: strict-origin-when-cross-origin (services/sportsdesk_webview_server.ts, baseHeaders).                                                                                      | Implemented for local daemon responses (`services/sportsdesk_webview_server.ts:843-857`). Upstream cloud response headers were not captured. |
| `X-Content-Type-Options`  | `nosniff`                                                                          | X-Content-Type-Options: nosniff (services/sportsdesk_webview_server.ts, baseHeaders).                                                                                                       | Implemented for local daemon responses (`services/sportsdesk_webview_server.ts:843-857`). Upstream cloud response headers were not captured. |

## Authentication & sessions

### `fantasy402Cookie`

**Declared type:** apiKey in `cookie` named `session`.

Fantasy402 Manager portal session. [OBSERVED] 2026-11-01: a Manager page sends `Authorization: Bearer &lt;token>`, where the token is `sessionStorage.credentials.code` after login. The same request without that header is refused with 401 by openresty, so the cookie alone is not sufficient. The 2026-10-28 HAR carried no Authorization header, which is now contradicted. The cookie name is unrecorded, so 'session' is a placeholder label.

Observed: the 2026-10-28 Manager HAR session is cookie-based and sent no Authorization header (`docs/runbooks/operational_guardrails_runbook.md:153`). The 2026-10-31 captures record an `authorization` key with a **redacted** value, so whether the current session also sends a bearer token is **unverified — check this**. No login/`Set-Cookie` exchange was captured, so the cookie name, lifetime, renewal window and scope are **unverified**. Do not assume a JWT lifetime — the earlier “~20–25 minute” claim had no source and was removed.

### `daemonBearer`

**Declared type:** http `bearer`.

Static daemon admin token: Authorization: Bearer &lt;SPORTSDESK_ADMIN_TOKEN>, compared with crypto.timingSafeEqual (services/sportsdesk_webview_server.ts, adminRejection). The daemon answers 503 when SPORTSDESK_ADMIN_TOKEN is unset and 401 otherwise.

Implementation-verified: the local daemon compares `Authorization: Bearer <token>` against `SPORTSDESK_ADMIN_TOKEN` in constant time (`services/sportsdesk_webview_server.ts:257-276`), protects `/api/watchlist` and `/api/telegram/*` (`services/sportsdesk_webview_server.ts:3239-3248`) and returns 503 when the token is not configured.

### Session lifecycle

No login, refresh or logout exchange was captured in this release. The only real wire artifact is the 2026-10-28 Manager HAR request capture, which shows a cookie-based session and no `Authorization` header; its response bodies and `Set-Cookie` were not captured. Treat any token lifetime, refresh window or logout behaviour as a **proposal** until captured (see [docs/evidence/capture-requests.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/capture-requests.md)).

## Endpoint reference

One section per operation present in the final spec. Each section starts with its evidence badge; parameters, request bodies and responses are shown only as far as the evidence tier allows.

### `POST /cloud/api/Manager/getScores`

> **Evidence — tier B** · sources: `main:scripts/portal_tile_crawler.ts:134-149`, `main:scripts/portal_tile_crawler.ts:545-670`, `docs/evidence/capture-requests.md` · response not captured · candidate URL+method (not observed on the wire)

**Scores leaderboard (request observed 2026-11-02; response shape partly observed)**

The Scores panel sends JSON, not a form: {customerID, operation: "getScoresLiveDynamic", RRO: 1, agentID, agentOwner} (operator transcript, 2026-11-02 — no capture artifact exists, so this is a recorded payload rather than a hashed capture). The response is an object with a Scores array; three field names were observed — LogoTeam1, LogoTeam2 and BroadcastInfo — and the logo fields are the portal's image file names (Boston-Celtics.png, Notre Dame Fighting Irish.png, miami_dolphins_logo.png, NHL.png in a team slot), not team names. Every other field is unknown and is not published. The tile's candidate URL (/cloud/api/Manager/getScores) and the path the page actually calls (/cloud/api/Report/getScoresLiveDynamic) disagree; the observed one is authoritative for the panel and the candidate row is kept only so the disagreement stays visible.

- **Tag:** Forensic Surveillance · **operationId:** `postCloudApiManagerGetScores`
- **Required capture:** A redacted capture of POST /cloud/api/Report/getScoresLiveDynamic (request and response) to replace the 2026-11-02 operator transcript with an artifact. The request body and three response field names are known; the remaining fields and the non-200 statuses are not.

**Request body — `application/json`**

| Field        | Type    | Required | Description                                                 | Example |
| ------------ | ------- | -------- | ----------------------------------------------------------- | ------- |
| `operation`  | string  | yes      | —                                                           | —       |
| `customerID` | string  | no       | Logged-in account; the observed value was the master agent. | —       |
| `agentID`    | string  | no       | —                                                           | —       |
| `agentOwner` | string  | no       | —                                                           | —       |
| `RRO`        | integer | no       | —                                                           | `1`     |

**Responses**

- **HTTP 200** — An object with a Scores array. Only LogoTeam1, LogoTeam2 and BroadcastInfo were observed; the remaining fields are unknown, so the item schema is open.
  - content `application/json`: **authored response schema — no response body was captured**
    - `Scores` (array of object) — no description
- **Default response (status code not captured)** — Unknown — no response artifact was captured; status codes other than 200 are not documented.

### `POST /cloud/api/Manager/getWebLog`

> **Evidence — tier A** · sources: `capture:2026-10-31/getWebLog.post.json`, `sha256:3b9a7c7061285460ca36b821af59741f44ea79277ae8bfbe4d100e011f1185ac` · response captured

**Manager getWebLog (mode B request observed; request + response captured)**

Live-captured contract: 2026-10-31/getWebLog.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getWebLog at 2026-10-31T00:19:51.204Z with a 200 response (response body sha256 979266c4b6abea5fff0de99966ece0363c5354859c92f5260870ea9507d2abaf). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The request template is the previously observed Manager envelope.

- **Tag:** Forensic Surveillance · **operationId:** `postCloudApiManagerGetWebLog`

**Parameters**

| Name               | In     | Required | Type                            | Description                                                                                               |
| ------------------ | ------ | -------- | ------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `X-Requested-With` | header | yes      | string — one of: XMLHttpRequest | Observed on the captured 2026-10-28 mode-B Manager request. Whether the portal enforces it is unverified. |

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `actions`    | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `customerID` | string | no       | —           | —       |
| `end`        | string | no       | —           | —       |
| `ip`         | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |
| `start`      | string | no       | —           | —       |
| `type`       | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getWebLog.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `INFO` (string) — no description
    - `LIST` (array) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Manager/getInfoPlayer`

> **Evidence — tier A** · sources: `capture:2026-10-31/getInfoPlayer.post.json`, `sha256:79a5b83c3c818fe6f7356b334c7703839336c4de0857b6ca6f9f62df0938a49e` · response captured

**Manager getInfoPlayer (request + response captured)**

Live-captured contract: 2026-10-31/getInfoPlayer.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getInfoPlayer at 2026-10-31T00:19:51.314Z with a 200 response (response body sha256 3eeb9db890d90b53b1c51cf04b7d9c3a47cba5f4c64eac3b541e7f50d39a37e1). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The request template is the previously observed Manager envelope.

- **Tag:** Customer State Mutations · **operationId:** `postCloudApiManagerGetInfoPlayer`

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `customerID` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getInfoPlayer.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `INFO` (null) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `GET /api/agent-tree`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/agent-tree` · response not captured

**Agent hierarchy joined with the wager rollup**

Serves data/agent-tree.json plus per-agent exposure (sportsdesk_webview_server.ts#GET /api/agent-tree). The tree is built by scripts/build_agent_tree.ts from the portal's own baseHeriarchy parent pointers; keys are canonical agentLoginKey values, and keys owned by more than one AgentID are flagged rather than levelled. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN; proxied peers need it too unless SPORTSDESK_TRUST_PROXY=1. `?view=hierarchy` returns the same forest folded into children arrays with per-node rollups (`rollup.agents` = transitive agents below, `rollup.depth` = longest chain below, `depth` = chain depth from the root) and the payload's defects (missing parents, cycles, collision keys) — `lib/hierarchy_view.ts`. Depth comes from the parent edges and not from the `l` field: on the committed tree 1,951 of 2,272 edges increment by 1, 208 by 2 and 110 run 12→12 where `l` saturates, so `l` stays in the payload as `level` and disagreement accumulates to 2,255 of 2,276 nodes. Surface: surface.daemon-agent-tree (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiAgentTree`
- **Required capture:** HTTP capture of GET /api/agent-tree, with and without ?view=hierarchy (handler-verified only; no HTTP response was captured).

**Parameters**

| Name   | In    | Required | Type                       | Description                                                                                                                                 |
| ------ | ----- | -------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `view` | query | no       | string — one of: hierarchy | `hierarchy` folds the flat forest into children arrays with rollups and payload defects. Omit for the flat map plus per-agent wager counts. |

**Responses**

- **HTTP 200** — Parent-keyed agent forest with per-agent wager counts.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `schemaVersion` (integer) — no description
    - `source` (string) — no description
    - `agentCount` (integer) — no description
    - `roots` (array of string) — no description
    - `collisions` (array of object) — no description
    - `nodes` (object) — no description
    - `counts` (object) — no description
- **HTTP 404** — No tree built; run bun run build:agent-tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/agents/search`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/agents/search` · response not captured

**Agent lookup over the committed hierarchy**

Case-insensitive prefix-first search over data/agent-tree.json (services/sportsdesk_webview_server.ts#GET /api/agents/search). Requires q of at least two characters and clamps limit to 100. Loopback-gated, because agent names are identity data. Surface: surface.daemon-agent-search (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiAgentsSearch`
- **Required capture:** Not a capture gap: the tree is committed and the handler is the contract.

**Responses**

- **HTTP 200** — Matching agents with their level.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `query` (string) — no description
    - `count` (integer) — no description
    - `agents` (array of object) — no description
- **HTTP 400** — Query shorter than two characters.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/analysis`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/analysis` · response not captured

**Analysis report, or the reason it is not captured**

Validates the portal's filter vocabulary (services/sportsdesk_webview_server.ts#GET /api/analysis) and answers 200 only when a transcribed report matches the selection; otherwise 501 with the required capture. A 200 carries the rows, the published totals, a recomputed copy and a discrepancies array, so a transcription slip is visible rather than served as fact. Surface: surface.daemon-analysis (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiAnalysis`
- **Required capture:** Only the response of POST /cloud/api/Manager/getAgentPerformance is missing. The request is observed (2026-11-01, type=CP and CPS) and lib/f402_agent_performance_request.ts reproduces it byte for byte; no response body has ever been seen, so no column set is documented. Today a single Customer Performance result (Baseball, agent BILLY666, 2026-11-01) is transcribed from an operator paste.

**Responses**

- **HTTP 200** — A transcribed analysis report.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `available` (boolean) — no description
    - `rows` (array of object) — no description
    - `totals` (object) — no description
    - `recomputed` (object) — no description
    - `discrepancies` (array of object) — no description
- **HTTP 501** — No transcribed report matches this selection.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `requiredCapture` (string) — no description

### `GET /api/analysis/filters`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/analysis` · response not captured

**Analysis filter vocabulary transcribed from report.js**

Returns the report kinds (CP/CPS/CPV/G), the fourteen activity codes, the two group modes and the four week windows, with their provenance and the required capture (services/sportsdesk_webview_server.ts#GET /api/analysis/filters). Surface: surface.daemon-analysis (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiAnalysisFilters`
- **Required capture:** HTTP capture of GET /api/analysis/filters (handler-verified only).

**Responses**

- **HTTP 200** — Filter vocabulary with provenance.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `captured` (boolean) — no description
    - `reports` (array of object) — no description
    - `activities` (array of object) — no description
    - `groups` (array of object) — no description
    - `weeks` (array of object) — no description

### `GET /api/analysis/reports`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/analysis` · response not captured

**Transcribed analysis reports and their recorded context**

Lists each stored result with the selection it was run under, so a client can select one instead of reconstructing the filters (services/sportsdesk_webview_server.ts#GET /api/analysis/reports). The recorded context contains the agent login the report was run for, so this index is customer-identifying and carries the same guard as GET /api/analysis: a non-loopback peer must present SPORTSDESK_ADMIN_TOKEN (piiRejection), and a unix-socket listener requires it unless SPORTSDESK_TRUST_PROXY=1. Surface: surface.daemon-analysis (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiAnalysisReports`
- **Required capture:** HTTP capture of GET /api/analysis/reports (handler-verified only).

**Responses**

- **HTTP 200** — Stored reports with context.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `count` (integer) — no description
    - `reports` (array of object) — no description
- **HTTP 401** — Missing or wrong admin token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/bridge3c/status`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**GSLive Bridge 3c gap-halt boundary and telemetry status**

Reports the Class D GSLive gap halt boundary state, read-only enforcement contract, AJAX endpoint target, and recent bridge rollup telemetry cycle. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiBridge3cStatus`
- **Required capture:** HTTP capture of GET /api/bridge3c/status (handler-verified only).

**Responses**

- **HTTP 200** — Bridge 3c partition and telemetry status.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `boundary` (string) — no description
    - `readOnly` (boolean) — no description
    - `endpoint` (string) — no description
    - `userAgent` (string) — no description
    - `rollup` (object) — no description
    - `generatedAt` (string) — no description

### `GET /api/contests`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/contests` · response not captured

**Contest / futures list from the sports nav**

Every contest the nav links, keyed by contestNum with sport, market and subject parsed out of the padded type string (services/sportsdesk_webview_server.ts#GET /api/contests). The list is extracted from saved markup by scripts/extract_contests.ts. Surface: surface.daemon-contests (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiContests`
- **Required capture:** A contest API capture would replace the markup extraction; none exists.

**Responses**

- **HTTP 200** — Contests with their group counts.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `count` (integer) — no description
    - `entries` (array of object) — no description
- **HTTP 404** — No contest list extracted.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/customer/profile`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/analysis` · response not captured

**Comprehensive customer profiling and behavioral forensics**

Generates a multi-dimensional customer behavioral profile including stake distribution, Gini inequality, market specialization, syndicate cluster analysis, reverse DNS classification, portfolio risk forensics, correlated parlay exposure, and composite sharpness tier. Guarded by PII rejection: non-loopback clients must present SPORTSDESK_ADMIN_TOKEN. Surface: surface.daemon-analysis (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiCustomerProfile`
- **Required capture:** HTTP capture of GET /api/customer/profile (handler-verified only).

**Parameters**

| Name | In    | Required | Type   | Description                                     |
| ---- | ----- | -------- | ------ | ----------------------------------------------- |
| `id` | query | yes      | string | Customer login ID (e.g. SYNTH_SYN_01 or RF2003) |

**Responses**

- **HTTP 200** — Comprehensive customer profile envelope.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `profile` (object) — no description
    - `generatedAt` (string) — no description
- **HTTP 400** — Missing required customer ID parameter.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 404** — Customer record not found.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/customer/rating`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/analysis` · response not captured

**Customer rating with Bayesian skill and Kelly sizing metrics**

Evaluates a bettor's sharpness using Bayesian win rate skill inference, fractional Kelly stake optimization, CLV t-statistic significance, component scoring, and desk action directives. Guarded by PII rejection. Surface: surface.daemon-analysis (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiCustomerRating`
- **Required capture:** HTTP capture of GET /api/customer/rating (handler-verified only).

**Parameters**

| Name | In    | Required | Type   | Description       |
| ---- | ----- | -------- | ------ | ----------------- |
| `id` | query | yes      | string | Customer login ID |

**Responses**

- **HTTP 200** — Customer rating envelope.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `rating` (object) — no description
    - `generatedAt` (string) — no description
- **HTTP 400** — Missing required customer ID parameter.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 404** — Customer record not found.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/dns/telemetry`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Bun native DNS resolver cache telemetry and core host metrics**

Operational telemetry reporting Bun's native DNS subsystem statistics: completed cache hits, inflight hits, misses, cache table size, hit rate percentage, and configured TTL settings. Surface: surface.daemon-dashboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiDnsTelemetry`
- **Required capture:** HTTP capture of GET /api/dns/telemetry (handler-verified only).

**Responses**

- **HTTP 200** — DNS cache telemetry envelope.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `telemetry` (object) — no description
    - `coreHosts` (array of object) — no description
    - `generatedAt` (string) — no description

### `POST /api/execution/mode`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Paper/paused/live mode switch (POST /api/execution/mode)**

Sets the in-memory execution mode and audits the change in the local execution ledger (services/sportsdesk_webview_server.ts#/api/execution/mode). `paper` and `paused` are always accepted; `live` requires `EXECUTION_LIVE=1`, a live-ready Kalshi adapter and `confirm:"LIVE"`, otherwise it answers 409 with the reasons. Admin-token/PII gate applies. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiExecutionMode`
- **Required capture:** HTTP capture of a paper→paused→paper round trip (handler-verified only).

**Request body — `application/json`**

| Field     | Type                                 | Required | Description | Example                   |
| --------- | ------------------------------------ | -------- | ----------- | ------------------------- |
| `mode`    | string — one of: paper, paused, live | yes      | —           | `paper`, `paused`, `live` |
| `confirm` | string                               | no       | —           | —                         |

**Responses**

- **HTTP 200** — Mode changed and audited.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `mode` (string) — no description
    - `previousMode` (string) — no description
    - `killSwitch` (boolean) — no description
    - `generatedAt` (string (date-time)) — no description
- **HTTP 400** — Invalid mode or body.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 409** — mode:"live" without EXECUTION_LIVE=1 + adapter credentials + confirm:"LIVE".
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
    - `reasons` (array of string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/execution/plan`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Execution plan, read-only (GET /api/execution/plan)**

Plans venue/style/size for the current watchlist signals from public books only (lib/execution_planner.ts, lib/execution_decision.ts; services/sportsdesk_webview_server.ts#/api/execution/plan). The engine is paper by default: decisions carry `paper`, `reasons` and `blockReason`, and this route never calls an order endpoint. Live readiness is reported per venue (Kalshi adapter credentials; Polymarket has no EIP-712 signer in this checkout). The body carries watchlist logins/risk, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiExecutionPlan`
- **Required capture:** HTTP capture of GET /api/execution/plan (handler-verified only; no HTTP response was captured and no live order exists to capture).

**Responses**

- **HTTP 200** — Plan envelope: mode/killSwitch/policy/venues/risk/decisions and the paper quote+fill tail.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `schemaVersion` (integer) — no description
    - `generatedAt` (string (date-time)) — no description
    - `mode` (string — one of: paper, paused, live) — no description
    - `killSwitch` (boolean) — no description
    - `policy` (object) — no description
    - `venues` (object) — no description
    - `risk` (object) — no description
    - `decisions` (array of object) — no description
    - `paper` (object) — no description
    - `blockedReasons` (object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `POST /api/execution/run`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Run the plan: paper fills, or gated live placement (POST /api/execution/run)**

Plans once, then paper-fills (taker book walk / resting maker quotes) unless `live:true` with `confirm:"PLACE LIVE ORDERS"` and every gate is satisfied, in which case only unblocked, non-paper Kalshi decisions are handed to the live adapter (services/sportsdesk_webview_server.ts#/api/execution/run, lib/kalshi_live_execution.ts). Polymarket live is always refused with its reason. One run per 2s answers 429. PII-gated. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiExecutionRun`
- **Required capture:** HTTP capture of a paper run with a temp ledger (handler-verified only); a live run is not possible in this checkout.

**Request body — `application/json`**

| Field     | Type    | Required | Description | Example |
| --------- | ------- | -------- | ----------- | ------- |
| `live`    | boolean | no       | —           | —       |
| `confirm` | string  | no       | —           | —       |

**Responses**

- **HTTP 200** — Paper fills/quotes, or live placement results.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `mode` (string) — no description
    - `generatedAt` (string (date-time)) — no description
    - `live` (boolean) — no description
    - `paper` (object) — no description
    - `placed` (array of object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 409** — Live run requested without the env flag, credentials or confirm phrase.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
    - `reasons` (array of string) — no description
- **HTTP 429** — A run happened less than 2s ago; retry after the given delay.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
    - `retryAfterMs` (number) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/f402/get-pending`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/v2/live-bets` · response not captured

**Retired Pending endpoint (410 tombstone)**

Answers 410 with a pointer to /api/live-bets (services/sportsdesk_webview_server.ts#/api/f402/get-pending). It used to return the same dataset in a different shape; the tombstone makes an old client fail loudly instead of silently reading a fixture that looks live. Surface: surface.daemon-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiF402GetPending`
- **Required capture:** HTTP capture of the 410 body (handler-verified only).

**Responses**

- **HTTP 410** — The endpoint is gone; the body names its replacements.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/game-admin`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/game-admin` · response not captured

**Exposure per fixture with a Straight/Parlay/Teaser split**

The portal manual's Game Admin report (v1.0.280, F.A.Q. #4) reduced to exposure per fixture and position (sportsdesk_webview_server.ts#GET /api/game-admin). preGame is computed from gameDateTime against the request clock and is a fact about the fixture, not a claim about the operator's delete permission. Surface: surface.daemon-game-admin (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGameAdmin`
- **Required capture:** HTTP capture of GET /api/game-admin (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Fixtures ordered by exposure, with positions.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `source` (string) — no description
    - `games` (array of object) — no description
    - `generatedAt` (string (date-time)) — no description

### `GET /api/game-admin/board`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/game-admin` · response not captured

**Game Admin board: lines with the money on each side**

Serves the transcribed Admin module: spread, moneyline, total and team-total sides with exposure (services/sportsdesk_webview_server.ts#GET /api/game-admin). Supports the portal's window selector (48 yesterday, 24 today, -1 current board). Abbreviated amounts carry amountExact null and are excluded from sums. Surface: surface.daemon-game-admin-board (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGameAdminBoard`
- **Required capture:** A Game Admin API capture would replace the transcription; none exists, so source and observedAt travel with the payload.

**Responses**

- **HTTP 200** — Board games, their sides and the window summary.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `window` (string) — no description
    - `games` (array of object) — no description
    - `summary` (object) — no description
- **HTTP 400** — Unknown window code.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/graph-feed`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Graph live feed (GET /api/graph-feed, /graph-live-feed.json)**

Serves docs/graph-live-feed.json — the same dataset docs/graph.html embeds — with no-store caching (services/sportsdesk_webview_server.ts#/api/graph-feed). It carries agent logins, so it uses the same `pii` guard as the page. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGraphFeed`
- **Required capture:** HTTP capture of GET /api/graph-feed (the artifact is committed; no HTTP response was captured).

**Responses**

- **HTTP 200** — The graph feed document as stored in docs/graph-live-feed.json.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/graph/stream`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Dashboard summary stream (GET /api/graph/stream, SSE)**

Server-sent events: the first `event: summary` frame carries the /api/graph/summary body; every 5s a stat fingerprint (feed, junit, census/weblog/live-bets, route table) is re-read and a fresh summary frame is emitted only when it changed, and every 5s a `: heartbeat &lt;epochMs>` comment is sent — 5s because Bun's default idleTimeout is 10s, so a 15s beat would leave the server free to close between beats (services/sportsdesk_webview_server.ts#/api/graph/stream). Timers are cleared on client abort. It streams the guarded summary, so it uses the same `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGraphStream`
- **Required capture:** HTTP capture of one SSE connection, including the initial summary frame and a heartbeat (handler-verified only; no streaming response was captured).

**Responses**

- **HTTP 200** — SSE stream: `event: summary` frames and `: heartbeat` comments, blank-line terminated.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `text/event-stream`: **authored response schema — no response body was captured**
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/graph/summary`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Derived dashboard summary (GET /api/graph/summary)**

Derives every metric docs/graph.html renders — feed counts, repo routes/citations/tests/typecheck/docs/head, bridge values and live process status — from the checkout's own artifacts (lib/dashboard_metrics.ts, services/sportsdesk_webview_server.ts#/api/graph/summary). Each section carries source/asOf/ageSeconds/stale, and an unmeasured metric is `not_measured` with the command that would measure it; it never reports a fabricated zero. It reads captures and the route catalog, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGraphSummary`
- **Required capture:** HTTP capture of GET /api/graph/summary (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Summary envelope: schemaVersion 1 with feed, repo, bridges and status blocks.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `schemaVersion` (integer) — no description
    - `generatedAt` (string (date-time)) — no description
    - `feed` (object) — no description
    - `repo` (object) — no description
    - `bridges` (array of object) — no description
    - `status` (object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/gslive/session-health`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**GSLive Manager Tools session health (GET /api/gslive/session-health)**

Reports the resolved credential source and a cached cookie-only probe of `GET /manager-tools/partnerConfig/` (lib/gslive_session_health.ts, lib/manager_session.ts). Never returns the GSID value: only cookie names, source, probe status/httpStatus/latency, and an advisory. A 403 with `cf-mitigated` is a human challenge; 302/401/HTML-200 is an expired cookie. The v4 GETs need no `x-gs-session`, and the daemon holds no per-run signin session. Uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGsliveSessionHealth`
- **Required capture:** HTTP capture of GET /api/gslive/session-health (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Session health: resolution source, cookie names only, cached probe classification and advisory.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `schemaVersion` (integer) — no description
    - `generatedAt` (string (date-time)) — no description
    - `authModel` (object) — no description
    - `session` (object) — no description
    - `probe` (object) — no description
    - `surfaceMap` (array of object) — no description
    - `advisory` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/gslive/weblogs`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**GSLive WebLog activity (GET /api/gslive/weblogs)**

Serves the last GSLive WebLog audit pass from the local git-ignored artifact (lib/gslive_weblog_activity.ts, services/sportsdesk_webview_server.ts#/api/gslive/weblogs). Local-only: a request never touches GSLive or the network; a missing/stale artifact is `not_measured`/`stale` with the `bun run gslive:weblogs:refresh` command instead of zeros. Rows carry account logins and audit flags, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiGsliveWeblogs`
- **Required capture:** HTTP capture of GET /api/gslive/weblogs (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Activity envelope: measured or not_measured, source/asOf/ageSeconds/stale, account rows and summary.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `schemaVersion` (integer) — no description
    - `generatedAt` (string (date-time)) — no description
    - `status` (string — one of: measured, not_measured) — no description
    - `source` (string) — no description
    - `asOf` (string) — no description
    - `ageSeconds` (number) — no description
    - `stale` (boolean) — no description
    - `accounts` (array of object) — no description
    - `summary` (object) — no description
    - `reason` (string) — no description
    - `command` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/kpis`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Dashboard headline KPIs (GET /api/kpis)**

Derives the dashboard's KPI strip from the artifacts the daemon serves (lib/desk_kpis.ts#deriveDeskKpis): agent counts from data/agent-tree.json, open wagers from data/live-bets.json, the ticker subset from data/live-wagers.json, and the customer book from data/customer-profiles.json. Each block is null when its file is absent and carries {source, basis, asOf, asOfFrom, ageSeconds, stale, partial}; `basis: fixture` marks demo data (the customer book is built from enriched_customers_full.json). Money is integer cents. Public by the table's `aggregate` classification — counts and sums only, no login, customer id or agent key. Surface: surface.daemon-dashboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiKpis`
- **Required capture:** HTTP capture of GET /api/kpis (the route is handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Derived KPI blocks with per-block provenance and staleness.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `kpis` (object) — no description
    - `generatedAt` (string (date-time)) — no description

### `GET /api/live-bets`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/v2/live-bets` · response not captured

**Deprecated alias redirecting (308) to /api/v1/live-bets**

Deprecated alias for /api/v1/live-bets (sportsdesk_webview_server.ts#GET /api/live-bets). Guards non-loopback peers with piiRejection, then answers 308 Permanent Redirect to /api/v1/live-bets preserving query parameters and setting X-Deprecation: /api/v2/live-bets; sunset=2027-05-10. Surface: surface.daemon-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiLiveBets`
- **Required capture:** HTTP capture of GET /api/live-bets redirect response (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 308** — Permanent redirect to /api/v1/live-bets with X-Deprecation header.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`

### `GET /api/live-bets/summary`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/v2/live-bets` · response not captured

**Aggregates only, without the game list**

Same aggregates as GET /api/live-bets, computed from the same rows in the same request (sportsdesk_webview_server.ts#GET /api/live-bets/summary), so the two responses cannot disagree. Totals are derived, never stored. The byAgent buckets are keyed by agent login, so the route carries the same PII guard as GET /api/live-bets and answers Cache-Control: private with Vary: Authorization: a shared cache must not replay a body the guard released to one peer. Surface: surface.daemon-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiLiveBetsSummary`
- **Required capture:** HTTP capture of GET /api/live-bets/summary (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Derived totals with their data source.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `summary` (object) — no description
    - `generatedAt` (string (date-time)) — no description

### `GET /api/live-wagers`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/live-wagers` · response not captured

**Live wager ticker list with parsed legs**

The {LIST: [...]} bet-ticker feed, which differs from Report/Pending: WagerNumber is the ticket id and ShortDesc carries one line per leg (services/sportsdesk_webview_server.ts#/api/live-wagers). Both ShortDesc grammars are parsed and the compact one is flagged; VolumeAmount differing from AmountWagered is reported, not reconciled. The response carries the file's own provenance — source, observedAt and captureNote — so a partial list reads as partial instead of as the whole ticker. Candidates are data/bet-ticker.json (a full Manager/getBetTicker capture written by `bun run capture:bet-ticker`, gitignored) and the local gitignored data/live-wagers.json artifact; a file is valid only if it parses as JSON and is a wager list ({LIST: [...]} or a bare array), and the valid one observed later wins: a provenance.observedAt that parses and is not in the future outranks any file mtime (the file's mtime changes on checkout), mtime only orders two undated files, and a tie goes to bet-ticker — services/sportsdesk_webview_server.ts#/api/live-wagers, shared with /api/kpis. `freshness` ({asOf, asOfFrom, stale}, stale after 3600 s) dates the chosen file — no ageSeconds, because the body is cached by version and the page derives the age from asOf, and `skipped` lists each present file that was not served with its reason (invalid JSON, no LIST array, older than the other); the 404 carries `skipped` too, so a malformed capture is reported rather than answered with a 500 or zero wagers. Loopback-gated. Surface: surface.daemon-live-wagers (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiLiveWagers`
- **Required capture:** An HTTP capture of GET /api/live-wagers serving a `capture:bet-ticker` artifact. No such run has been recorded; a local data/live-wagers.json artifact may hold a partial clipboard paste, and its `partial` flag and captureNote must say so.

**Responses**

- **HTTP 200** — Wagers with aggregates and their provenance.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `summary` (object) — no description
    - `all` (object) — no description
    - `provenance` (object) — no description
    - `freshness` (object) — no description
    - `skipped` (array of object) — no description
    - `wagers` (array of object) — no description
- **HTTP 404** — No valid live wager list.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description
    - `hint` (string) — no description
    - `skipped` (array of object) — no description

### `GET /api/logo/{name}`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1591-1687` · response not captured

**Team-logo proxy (GET /api/logo/{name})**

Fetches https://cdn.fastassets.io/images/team-logos/{name} and returns the image bytes with an immutable day-long cache (services/sportsdesk_webview_server.ts#/api/logo/{name}). Names are validated by rejecting separators, control characters and `..` rather than by allowlisting the characters the feed happens to use, so a traversal never reaches the upstream URL; a malformed percent-escape is 400, not the 500 it used to be. Public: it returns image bytes for a fixed host and carries no customer data; the response content type mirrors the upstream's (png, jpeg, gif, webp or svg), and the 200 schema below is the common case. Surface: surface.daemon-logo-proxy (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiLogoName`
- **Required capture:** HTTP capture of one logo fetch, including a 404 from the CDN, to record the upstream status passthrough.

**Parameters**

| Name   | In   | Required | Type   | Description                                                                                                                                                 |
| ------ | ---- | -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | path | yes      | string | Logo file name from the wager feed, e.g. `Arsenal FC.png`; must end in .png/.jpg/.jpeg/.gif/.webp/.svg and contain no separator, control character or `..`. |

**Responses**

- **HTTP 200** — The upstream image bytes, cached for one day.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `image/png`: **authored response schema — no response body was captured**
- **HTTP 400** — Missing, malformed or disallowed name — including a broken percent-escape.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `text/plain`: **authored response schema — no response body was captured**
- **HTTP 502** — The upstream answered but not with an image.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-ajax-xml`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**AJAX XML parse (POST /api/parse-ajax-xml)**

Parses one AJAX-delivered XML response via parseAjaxXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseAjaxXml`
- **Required capture:** HTTP capture of a POST /api/parse-ajax-xml round trip.

**Responses**

- **HTTP 200** — The parsed document as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-bet-ticker`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Bet-ticker XML parse (POST /api/parse-bet-ticker)**

Parses one bet-ticker XML feed via parseBetTickerXml (lib/live_wagers.ts) and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseBetTicker`
- **Required capture:** HTTP capture of a POST /api/parse-bet-ticker round trip.

**Responses**

- **HTTP 200** — The parsed feed as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-customer-performance`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Customer performance XML parse (POST /api/parse-customer-performance)**

Parses one customer-performance XML document via parseCustomerPerformanceXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseCustomerPerformance`
- **Required capture:** HTTP capture of a POST /api/parse-customer-performance round trip.

**Responses**

- **HTTP 200** — The parsed document as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-customer-profile`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Customer profile XML parse (POST /api/parse-customer-profile)**

Parses one customer-profile XML document via parseCustomerProfileXml (lib/customer_profile.ts) and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseCustomerProfile`
- **Required capture:** HTTP capture of a POST /api/parse-customer-profile round trip.

**Responses**

- **HTTP 200** — The parsed profile as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-fantasy402-ajax`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Fantasy402 AJAX XML parse (POST /api/parse-fantasy402-ajax)**

Parses one Fantasy402 AJAX XML response via parseFantasy402AjaxXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseFantasy402Ajax`
- **Required capture:** HTTP capture of a POST /api/parse-fantasy402-ajax round trip.

**Responses**

- **HTTP 200** — The parsed document as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-formdata`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Form-data parse probe (POST /api/parse-formdata)**

Echoes the fields of one multipart or urlencoded body as {name: string | string[]} (services/sportsdesk_webview_server.ts#/api/parse-formdata). Reads through `req.formData()`, which on 1.4.4 succeeds where `new Blob([await req.arrayBuffer()]).formData()` rejected Bun's own encoding; the body is bounded by the daemon's 1 MiB maxRequestBodySize. Public, and the reason the cap exists. Surface: surface.daemon-dashboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseFormdata`
- **Required capture:** HTTP capture of a POST /api/parse-formdata round trip (multipart and urlencoded).

**Responses**

- **HTTP 200** — The submitted fields; a repeated name becomes an array of strings.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as form data.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description
- **HTTP 413** — The body exceeded the daemon's 1 MiB maxRequestBodySize. Bun refuses it before the handler runs, so the body is empty (measured on 1.4.4: status 413, no content-type) rather than the daemon's JSON error shape.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`

### `POST /api/parse-toml`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**TOML parse (POST /api/parse-toml)**

Parses one TOML document via parseToml and returns the result. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseToml`
- **Required capture:** HTTP capture of a POST /api/parse-toml round trip.

**Responses**

- **HTTP 200** — The parsed document.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as TOML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-transactions`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Transactions XML parse (POST /api/parse-transactions)**

Parses one transactions XML document via parseTransactionsXml and returns the compact tree. Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseTransactions`
- **Required capture:** HTTP capture of a POST /api/parse-transactions round trip.

**Responses**

- **HTTP 200** — The parsed document as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `POST /api/parse-xml`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**XML parse probe (POST /api/parse-xml)**

Parses one XML body with Bun.XML.parse and returns the compact tree (services/sportsdesk_webview_server.ts#/api/parse-xml). Body bounded by the daemon's 1 MiB maxRequestBodySize. Public.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiParseXml`
- **Required capture:** HTTP capture of a POST /api/parse-xml round trip (well-formed XML).

**Responses**

- **HTTP 200** — The parsed XML as a compact object tree.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
- **HTTP 400** — The body is not parseable as XML.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/scoreboard`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:3193-3205` · response not captured

**Transcribed portal scoreboard (games, scores, status)**

Serves data/scoreboard.json with a status summary (sportsdesk_webview_server.ts#GET /api/scoreboard). The games are transcribed from the manager page, not captured from an API, so the payload carries source and observedAt. Surface: surface.daemon-scoreboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiScoreboard`
- **Required capture:** HTTP capture of GET /api/scoreboard (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Scoreboard rows with status counts.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `schemaVersion` (integer) — no description
    - `source` (string) — no description
    - `observedAt` (string) — no description
    - `notes` (array of string) — no description
    - `games` (array of object) — no description
    - `summary` (object) — no description
- **HTTP 404** — No scoreboard file present.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/signals/kalshi`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1914-2592`, `services/sportsdesk_webview_server.ts#GET /agent-graph.webp` · response not captured

**Watchlist signals joined to Kalshi markets (GET /api/signals/kalshi)**

Derives watchlist signals from the graph feed's pendingBets, data/live-wagers.json and data/live-bets.json (lib/watchlist_signal_engine.ts), then joins each to one open Kalshi market and walks its order book for liquidity and an executable edge (lib/kalshi_signal_join.ts, services/sportsdesk_webview_server.ts#/api/signals/kalshi). Read-only: the Kalshi client (lib/kalshi_client.ts) uses public GET endpoints only, sends no auth header, and ignores KALSHI_API_KEY; no order or portfolio endpoint is reachable. A fixture-sourced signal is capped at `fixture_only`; network failure is `degraded` with a reason instead of a fabricated price. The body carries watchlist logins and risk, so it uses the graph plane's `pii` guard. Surface: surface.daemon-graph-data-plane (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiSignalsKalshi`
- **Required capture:** HTTP capture of GET /api/signals/kalshi (handler-verified only; no HTTP response was captured), plus a Kalshi order-book capture for the liquidity fields.

**Responses**

- **HTTP 200** — Signal envelope: config thresholds, provenance, Kalshi telemetry (ok/degraded/requests/cacheHits/errors) and joined signals with a verdict.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `schemaVersion` (integer) — no description
    - `generatedAt` (string (date-time)) — no description
    - `config` (object) — no description
    - `provenance` (object) — no description
    - `kalshi` (object) — no description
    - `signals` (array of object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/sports`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/sports` · response not captured

**Portal sport taxonomy with counts per category**

Returns the 18 portal categories plus counts for the loaded wagers and the scoreboard (sportsdesk_webview_server.ts#GET /api/sports). All Sports is the absence of a filter and LIVE is a state, so neither is a category. Surface: surface.daemon-sports-taxonomy (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiSports`
- **Required capture:** HTTP capture of GET /api/sports (handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Taxonomy and the counts observed per category.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `liveFilter` (string) — no description
    - `all` (array of string) — no description
    - `wagers` (array of object) — no description
    - `scoreboard` (array of object) — no description

### `GET /api/sports/catalog`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:2954-3028` · response not captured

**Sub-sports and period menus with their types**

19 sports, 230 sub-sports and 42 period entries from the committed catalog fixture (services/sportsdesk_webview_server.ts#/api/sports/catalog). Period numbers are sport-specific, so periodTypes reports every name a number carries and flags the ambiguous ones; sub-sport codes shared by several sports are marked. Surface: surface.daemon-sport-catalog (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiSportsCatalog`
- **Required capture:** Not a capture gap: the catalog fixture is the captured artifact.

**Responses**

- **HTTP 200** — Catalog with derived indexes.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `summary` (object) — no description
    - `periodTypes` (array of object) — no description
    - `subSports` (array of object) — no description
    - `sports` (array of object) — no description
- **HTTP 404** — Unknown sport or sub-sport.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (string) — no description

### `GET /api/status`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Daemon status and process telemetry (GET /api/status, GET /status.json)**

Answers {ok, status, checks, health, telegram, timestamp} from the running process instead of fetching itself over the loopback (services/sportsdesk_webview_server.ts#/api/status); a self-fetch had no port at all under a unix socket. `ok` and `status` are derived from `checks`, so the degraded branch is reachable, and `cpuUsageSinceStartMicros` is cumulative CPU time rather than utilisation. HEAD is answered like GET. Public by the table's `operational` classification — it carries uptime, memory, pid and bind address, not customer data. Surface: surface.daemon-dashboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiStatus`
- **Required capture:** HTTP capture of GET /api/status (the route is handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Liveness, per-check results and process telemetry.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `ok` (boolean) — no description
    - `status` (string — one of: serving, degraded) — no description
    - `checks` (object) — no description
    - `health` (object) — no description
    - `telegram` (object) — no description
    - `timestamp` (string (date-time)) — no description

### `GET /api/telegram/activity`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#POST /telegram/webhook`, `services/sportsdesk_webview_server.ts#GET /api/telegram/status`, `services/sportsdesk_webview_server.ts:1139-1141,1132-1136` · response not captured

**Recent Telegram activity (GET /api/telegram/activity)**

Returns {success, entries} from the activity log; `limit` defaults to 50 and clamps to 1..200 (services/sportsdesk_webview_server.ts#/api/telegram/activity). Admin-token gated. Surface: surface.daemon-telegram-admin-routes (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiTelegramActivity`
- **Required capture:** HTTP capture of GET /api/telegram/activity with a valid token.

**Responses**

- **HTTP 200** — Newest-first activity entries.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `entries` (array of object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `POST /api/telegram/alert`

> **Evidence — tier B** · sources: `services/sportsdesk_webview_server.ts:3522-3556` · response not captured

**Dispatch an instant Telegram alert**

Request body {customerId, riskUSD} is required: customerId must be on the watch list and riskUSD positive, otherwise 400 TelegramTestAlertInputError. Dispatches a labelled synthetic test alert through telegramService.dispatchTestAlert and returns {success, ok, customerId} (services/sportsdesk_webview_server.ts). Admin-token gated (services/sportsdesk_webview_server.ts).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiTelegramAlert`
- **Required capture:** No capture gap; document the Authorization requirement and the 401/503 paths.

**Request body — `application/json`**

| Field        | Type   | Required | Description                              | Example |
| ------------ | ------ | -------- | ---------------------------------------- | ------- |
| `customerId` | string | yes      | Watch-list customer to alert.            | —       |
| `riskUSD`    | number | yes      | Stake shown on the synthetic test alert. | —       |

**Responses**

- **HTTP 200** — Alert dispatch result.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — Whether Telegram accepted the alert.
    - `customerId` (string) — no description
- **HTTP 400** — TelegramTestAlertInputError: customerId missing or not on the watch list, or riskUSD not positive (services/sportsdesk_telegram_bot.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 500** — Dispatch threw (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `POST /api/telegram/report`

> **Evidence — tier B** · sources: `services/sportsdesk_webview_server.ts#POST /api/telegram/report`, `services/sportsdesk_telegram_bot.ts:80-84` · response not captured

**Trigger a scheduled Telegram report**

Report type is selected by the ?type= query parameter and defaults to EVENING_SETTLEMENT; the handler validates it with isReportType and returns {success, ok, reportType} (services/sportsdesk_webview_server.ts). REPORT_TYPES are MORNING_BRIEFING, MIDDAY_STEAM and EVENING_SETTLEMENT (services/sportsdesk_telegram_bot.ts:80-84). Admin-token gated (services/sportsdesk_webview_server.ts).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiTelegramReport`
- **Required capture:** No capture gap; add the ?type= query parameter (enum REPORT_TYPES) and 'ok' to the spec.

**Parameters**

| Name   | In    | Required | Type                                                                | Description                                                                                      |
| ------ | ----- | -------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `type` | query | no       | string — one of: MORNING_BRIEFING, MIDDAY_STEAM, EVENING_SETTLEMENT | Report type; defaults to EVENING_SETTLEMENT when absent (services/sportsdesk_webview_server.ts). |

**Responses**

- **HTTP 200** — Report dispatch result.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — Whether Telegram accepted the report.
    - `reportType` (string — one of: MORNING_BRIEFING, MIDDAY_STEAM, EVENING_SETTLEMENT) — no description
- **HTTP 400** — type is not one of REPORT_TYPES (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/telegram/status`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#POST /telegram/webhook`, `services/sportsdesk_webview_server.ts#GET /api/telegram/status`, `services/sportsdesk_webview_server.ts:1139-1141,1132-1136` · response not captured

**Telegram configuration and schedules (GET /api/telegram/status)**

Returns {success, status, schedules, reportTypes} from the bot service and the in-process scheduler (services/sportsdesk_webview_server.ts#/api/telegram/status). Admin-token gated regardless of peer address. Surface: surface.daemon-telegram-admin-routes (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiTelegramStatus`
- **Required capture:** HTTP capture of GET /api/telegram/status with a valid token.

**Responses**

- **HTTP 200** — Bot mode, schedules and the report vocabulary.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `status` (object) — no description
    - `schedules` (array of object) — no description
    - `reportTypes` (array of string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `POST /api/telegram/webhook`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#POST /telegram/webhook`, `services/sportsdesk_webview_server.ts#GET /api/telegram/status`, `services/sportsdesk_webview_server.ts:1139-1141,1132-1136` · response not captured

**Register or delete the Telegram webhook (POST /api/telegram/webhook)**

Body {action: "set" | "delete"} calls telegramService.setWebhook()/deleteWebhook() and mirrors the Bot API result as {success, ok, error?}, 502 when Telegram refuses (services/sportsdesk_webview_server.ts#/api/telegram/webhook). Admin-token gated; this is the control plane, distinct from the secret-checked /telegram/webhook that receives updates. Surface: surface.daemon-telegram-admin-routes (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiTelegramWebhook`
- **Required capture:** HTTP capture of a set and a delete round trip against the Bot API.

**Request body — `application/json`**

| Field    | Type                         | Required | Description | Example         |
| -------- | ---------------------------- | -------- | ----------- | --------------- |
| `action` | string — one of: set, delete | yes      | —           | `set`, `delete` |

**Responses**

- **HTTP 200** — Telegram accepted the change.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — no description
    - `error` (string) — no description
- **HTTP 400** — action is missing or not "set"/"delete".
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 502** — Telegram answered ok:false; its description is passed through.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `ok` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /api/test/error`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#POST /telegram/webhook`, `services/sportsdesk_webview_server.ts#GET /api/telegram/status`, `services/sportsdesk_webview_server.ts:1139-1141,1132-1136` · response not captured

**Error-boundary probe (GET /api/test/error)**

Throws a string so the server's error boundary runs; `?trigger_error=non_error` does the same on any route (services/sportsdesk_webview_server.ts, baseHeaders). Deliberately reachable in production so a deployment can prove the 500 body carries no stack trace. Surface: surface.daemon-telegram-admin-routes (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiTestError`
- **Required capture:** HTTP capture of the 500 body in production (asserted by tests/server_error.test.ts, not captured as an artifact).

**Responses**

- **HTTP 500** — The daemon's structured 500: no stack, no source, only the thrown message.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
    - `message` (string) — no description

### `GET /api/v1/blobs/{key}`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:517-600` · response not captured

**Presigned download URL for one blob**

Bearer-auth GET redirects (302) to a presigned S3/R2 GET URL (services/blob_and_live_bets_server.ts). The key is validated before presigning; unknown keys are not probed, and a presign failure is 502. With `?download=1` the handler returns the object body directly via `new Response(S3File)` (200). Surface: surface.blob-live-bets (tier B).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiV1BlobsKey`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Parameters**

| Name       | In    | Required | Type               | Description                                            |
| ---------- | ----- | -------- | ------------------ | ------------------------------------------------------ |
| `key`      | path  | yes      | string             | Validated blob key; `..` and leading dots are refused. |
| `download` | query | no       | string — one of: 1 | Stream the object body (200) instead of redirecting.   |

**Responses**

- **HTTP 200** — Object body streamed from S3File.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/octet-stream`: **authored response schema — no response body was captured**
- **HTTP 302** — Redirect to a short-lived presigned URL.
  - response header `location`: declared, no example
- **HTTP 400** — Invalid blob key.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 502** — Presign failed.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `PUT /api/v1/blobs/{key}`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:517-600` · response not captured

**Bounded image upload, transcoded to WebP**

Bearer-auth PUT accepts image/jpeg|png|webp|avif|heic up to maxUploadBytes (default 5 MiB), rejects oversized bodies with 413 from both Content-Length and a streaming cap, decodes with Bun.Image under maxPixels (413), resizes inside 1280x1280 and encodes deterministic WebP (Bun.Image.backend = "bun"), then stores it. Response carries bytesWritten, bytes, width and height. Surface: surface.blob-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `putApiV1BlobsKey`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Parameters**

| Name  | In   | Required | Type   | Description                                            |
| ----- | ---- | -------- | ------ | ------------------------------------------------------ |
| `key` | path | yes      | string | Validated blob key; `..` and leading dots are refused. |

**Request body — `image/png`**

No declared fields.

**Responses**

- **HTTP 200** — Stored WebP metadata.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `key` (string) — no description
    - `bytesWritten` (integer) — no description
    - `bytes` (integer) — no description
    - `width` (integer) — no description
    - `height` (integer) — no description
- **HTTP 400** — Invalid blob key.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 413** — Body or decoded pixel count too large.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 415** — Unsupported image content type.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 422** — Image could not be decoded.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 502** — Store failed.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `DELETE /api/v1/blobs/{key}`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:601-619` · response not captured

**Delete one stored blob**

Bearer-auth DELETE validates the key, returns 404 when the blob is absent, removes the stored object and returns 204; a store failure is 502. Surface: surface.blob-live-bets (tier B).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `deleteApiV1BlobsKey`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Parameters**

| Name  | In   | Required | Type   | Description                                            |
| ----- | ---- | -------- | ------ | ------------------------------------------------------ |
| `key` | path | yes      | string | Validated blob key; `..` and leading dots are refused. |

**Responses**

- **HTTP 204** — Blob deleted.
- **HTTP 400** — Invalid blob key.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 404** — Blob not found.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 502** — Delete failed at the store.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `GET /api/v1/live-bets`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/v2/live-bets` · response not captured

**Frozen v1 live bets derived from captured Report/Pending rows**

Frozen v1 live-bets endpoint (sportsdesk_webview_server.ts#GET /api/v1/live-bets), preserved for existing callers while new integrations migrate to /api/v2/live-bets. Derives the scoreboard payload from real wager rows using lib/live_bets.ts and src/live_bets/resolve.ts, stripping Password/NameFirst/Login by name and keeping amounts in integer cents. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN (piiRejection). Surface: surface.daemon-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiV1LiveBets`
- **Required capture:** HTTP capture of GET /api/v1/live-bets against a real Report/Pending capture (the route is handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Games, agent rollup and the aggregates derived from them.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `games` (array of object) — no description
    - `agents` (object) — no description
    - `pendingCount` (integer) — no description
    - `summary` (object) — no description
    - `scoreboard` (object) — no description
    - `sports` (object) — no description
    - `generatedAt` (string (date-time)) — no description

### `POST /api/v1/live-bets`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:457-503` · response not captured

**Publish a live-bets event to subscribers**

Bearer-auth POST {channel, event} validates the channel, serializes the event and calls Server.publish; it returns the number of subscribers reached. Publishing is also exposed programmatically as publish(channel, event) on the server factory. Surface: surface.blob-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiV1LiveBets`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Request body — `application/json`**

| Field     | Type   | Required | Description                      | Example |
| --------- | ------ | -------- | -------------------------------- | ------- |
| `channel` | string | yes      | —                                | —       |
| `event`   | object | yes      | JSON-serializable event payload. | —       |

**Responses**

- **HTTP 200** — Subscriber count.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `channel` (string) — no description
    - `published` (integer) — no description
- **HTTP 400** — Invalid JSON, channel or body.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 413** — Body too large.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 422** — Event is not serializable.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `POST /api/v1/ws-tickets`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:432-456` · response not captured

**Short-lived one-time WebSocket ticket**

Bearer-auth POST returns {ticket, expiresInSec}. The ticket is HMAC-SHA256 over {exp, nonce}; issued nonces are kept in a pending allowlist capped at 4096 (429 when full), deleted on the first successful upgrade, and replayed/unissued tickets are rejected. Surface: surface.blob-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `postApiV1WsTickets`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Responses**

- **HTTP 200** — Ticket and TTL.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `ticket` (string) — no description
    - `expiresInSec` (integer) — no description
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 429** — Active-ticket cap reached.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `GET /api/v2/live-bets`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts#GET /api/v2/live-bets` · response not captured

**Live bets v2 with explicit source, fallback, provenance and warnings**

Resolves live-bets snapshots through resolveLiveBets (src/live_bets/resolve.ts, sportsdesk_webview_server.ts#GET /api/v2/live-bets) with explicit source (db | file | fixture | none; auto is rejected with 400) and fallback (strict | sample). Never returns a null dataSource or silently swallows missing files: strict returns dataSource: none with warnings, and sample records fallbackUsed and provenance.path/hash for whichever file answered. Non-loopback peers must present SPORTSDESK_ADMIN_TOKEN (piiRejection). Surface: surface.daemon-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiV2LiveBets`
- **Required capture:** HTTP capture of GET /api/v2/live-bets against a real Report/Pending capture (the route is handler-verified only; no HTTP response was captured).

**Parameters**

| Name       | In    | Required | Type                                     | Description |
| ---------- | ----- | -------- | ---------------------------------------- | ----------- |
| `source`   | query | no       | string — one of: db, file, fixture, none | —           |
| `fallback` | query | no       | string — one of: strict, sample          | —           |
| `path`     | query | no       | string                                   | —           |

**Responses**

- **HTTP 200** — Resolved v2 live-bets payload with provenance and warnings.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `apiVersion` (string — one of: 2) — no description
    - `dataSource` (string — one of: db, file, fixture, none) — no description
    - `fallbackUsed` (boolean) — no description
    - `provenance` (object) — no description
    - `games` (array of object) — no description
    - `warnings` (array of string) — no description
    - `agents` (object) — no description
    - `pendingCount` (integer) — no description
    - `summary` (object) — no description
    - `scoreboard` (object) — no description
    - `sports` (object) — no description

### `GET /api/watchlist`

> **Evidence — tier B** · sources: `services/sportsdesk_webview_server.ts#GET /api/watchlist`, `services/sportsdesk_webview_server.ts:257-276` · response not captured

**Monitored watch-list accounts**

Returns {success, count, data} from telegramService.getWatchList() (services/sportsdesk_webview_server.ts). Requires Authorization: Bearer &lt;SPORTSDESK_ADMIN_TOKEN>; adminRejection returns 503 when the token is unset and 401 otherwise (services/sportsdesk_webview_server.ts).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getApiWatchlist`
- **Required capture:** No wire capture needed; add the 401/503 responses to the spec from adminRejection (services/sportsdesk_webview_server.ts:257-276).

**Responses**

- **HTTP 200** — Watch-list snapshot.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `count` (integer) — no description
    - `data` (array of object) — no description
- **HTTP 401** — Missing or wrong admin token (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description
- **HTTP 503** — SPORTSDESK_ADMIN_TOKEN is not set on the server (services/sportsdesk_webview_server.ts).
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `success` (boolean) — no description
    - `error` (string) — no description

### `GET /dashboard`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1792-1799` · response not captured

**Operator dashboard (GET /dashboard)**

Serves customer-churn-simulation-dashboard.html as text/html (services/sportsdesk_webview_server.ts#/dashboard). The same handler also answers GET /; the root path is not modelled as an OpenAPI path because the ledger has no dedicated surface row for it. Surface: surface.daemon-dashboard (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getDashboard`
- **Required capture:** HTTP capture of the served /dashboard HTML (the route is handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Operator dashboard HTML with the daemon CORS/CSP headers.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `text/html`: **authored response schema — no response body was captured**

### `GET /health`

> **Evidence — tier B** · sources: `services/sportsdesk_webview_server.ts:1704-1720` · response not captured

**Daemon health and telemetry probe**

Handler-defined contract: services/sportsdesk_webview_server.ts returns the daemon's status, bound port/hostname, Bun-reported URL, timestamp, uptime, runtime and NODE_ENV. Verified against the handler source, not an HTTP capture. The daemon binds 0.0.0.0 by default (services/sportsdesk_webview_server.ts,1622-1625), so the example hostname is 0.0.0.0; the http://127.0.0.1:4020 server target is a loopback client view of that bind.

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getHealth`
- **Required capture:** Not a capture gap: reconcile the spec to services/sportsdesk_webview_server.ts:1704-1720 (add url + timestamp). A curl capture would only confirm the handler.

**Responses**

- **HTTP 200** — Healthy daemon status.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `status` (string) — no description
    - `port` (integer) — Bound port; PORT defaults to 4020.
    - `hostname` (string) — Bound hostname. Bun serves on all interfaces by default (0.0.0.0).
    - `url` (string) — server.url as reported by Bun; with hostname 0.0.0.0 the daemon is reachable on all interfaces.
    - `timestamp` (string (date-time)) — no description
    - `uptimeSeconds` (integer) — no description
    - `runtime` (string) — no description
    - `ingress` (object) — Peer-trust rule in force, so 'is the PII guard on?' is answerable from the probe. `proxied` is true when the daemon listens on a unix socket and therefore cannot see the client; `trustProxy` is SPORTSDESK_TRUST_PROXY=1.
    - `nodeEnv` (string) — no description

### `GET /miniapp`

> **Evidence — tier D** · sources: `services/sportsdesk_webview_server.ts:1812-1819`, `services/sportsdesk_webview_server.ts:847-848` · response not captured

**Telegram Mini App dashboard (GET /miniapp)**

Serves telegram-miniapp-dashboard.html as text/html (services/sportsdesk_webview_server.ts#/miniapp) with Telegram frame-ancestors CSP and no X-Frame-Options (services/sportsdesk_webview_server.ts#/miniapp). GET /miniapp/ is an alias. Surface: surface.daemon-miniapp (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getMiniapp`
- **Required capture:** HTTP capture of the served /miniapp HTML (the route is handler-verified only; no HTTP response was captured).

**Responses**

- **HTTP 200** — Mini App dashboard HTML with the daemon CORS/CSP headers.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `text/html`: **authored response schema — no response body was captured**

### `GET /ws/live-bets`

> **Evidence — tier B** · sources: `services/blob_and_live_bets_server.ts:620-649` · response not captured

**Live-bets WebSocket upgrade**

Upgrade requires a valid unused ticket, via ?ticket= or Sec-WebSocket-Protocol: live-bets.v1, ticket.&lt;token> (the server echoes live-bets.v1). Messages are capped (1009), JSON-validated and limited to PING/SUBSCRIBE/UNSUBSCRIBE with channel regex checks. Surface: surface.blob-live-bets (tier D).

- **Tag:** Local Desk &amp; Telegram Gateway · **operationId:** `getWsLiveBets`
- **Required capture:** No live HTTP capture exists; this row is handler-verified tier B. Capture one live request/response to promote it to tier A.

**Parameters**

| Name     | In    | Required | Type   | Description                                                           |
| -------- | ----- | -------- | ------ | --------------------------------------------------------------------- |
| `ticket` | query | no       | string | One-time HMAC ticket; the subprotocol form is preferred for browsers. |

**Responses**

- **HTTP 101** — Switching Protocols.
- **HTTP 401** — Missing or wrong bearer token.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description
- **HTTP 426** — Upgrade required.
  - response header `Content-Security-Policy`: value `frame-ancestors 'self' https://web.telegram.org https://*.telegram.org telegram:`
  - response header `X-Content-Type-Options`: value `nosniff`
  - response header `Referrer-Policy`: value `strict-origin-when-cross-origin`
  - content `application/json`: **authored response schema — no response body was captured**
    - `error` (object) — no description

### `POST /cloud/api/Manager/getAgentPerformance`

> **Evidence — tier B** · sources: `tests/fixtures/f402-report-requests-observed-2026-11-01.json`, `app/manager/module/agent-performance.js?bust=1.0.280` · response not captured · **contradicted by a concrete artifact**

**Agent performance report (request observed; response not captured)**

Request observed 2026-11-01 on the agent-performance screen: a form-urlencoded POST whose fields are published below in wire order (tests/fixtures/f402-report-requests-observed-2026-11-01.json). Three calls were seen — CP and CPS report kinds — and two details matter: `sport` is padded to 20 characters, and `tipo` is not a constant (0 for CP, -1 for CPS). No response body was ever observed, so no response schema is published and nothing here describes the report's columns.

- **Tag:** Downline Accounting · **operationId:** `postCloudApiManagerGetAgentPerformance`
- **Required capture:** The request is now observed in full, with its URL; only the response is missing. Capture one call and its rows, then confirm whether holdPct is computed server-side and how BranchGrade is applied. Upgrades B->A.
- **Contradiction:** A concrete artifact refutes a claim previously made for this operation; see docs/EVIDENCE.md for the evidence.

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type                                 | Required | Description                                                                                   | Example               |
| ------------ | ------------------------------------ | -------- | --------------------------------------------------------------------------------------------- | --------------------- |
| `start`      | string                               | yes      | M/D/YYYY.                                                                                     | —                     |
| `end`        | string                               | yes      | M/D/YYYY.                                                                                     | —                     |
| `agentID`    | string                               | yes      | —                                                                                             | —                     |
| `type`       | string                               | yes      | Report kind: CP (customer performance) or CPS (sport performance) observed.                   | —                     |
| `freePlay`   | string — one of: Y, N                | yes      | —                                                                                             | `Y`, `N`              |
| `store`      | string                               | yes      | Equals agentID in every observed call.                                                        | —                     |
| `sport`      | string                               | yes      | Sport name padded with spaces to exactly 20 characters (Football, Auto Racing, Tennis, LIVE). | —                     |
| `subsport`   | string                               | yes      | Catalog sub-sport code (NFL, NCAAF Live, …); empty string when unfiltered.                    | —                     |
| `period`     | string                               | yes      | Portal period number for that sport, or -1 for all periods. LIVE's menu has only 0 (Game).    | —                     |
| `wagerType`  | string                               | yes      | Raw portal code; empty when unfiltered.                                                       | —                     |
| `betType`    | string                               | yes      | Raw portal code; empty when unfiltered.                                                       | —                     |
| `tipo`       | string                               | yes      | Observed as 0 for CP and -1 for CPS; not a constant.                                          | —                     |
| `debug`      | string — one of: 0                   | yes      | —                                                                                             | `0`                   |
| `operation`  | string — one of: getAgentPerformance | yes      | —                                                                                             | `getAgentPerformance` |
| `RRO`        | string — one of: 1                   | yes      | —                                                                                             | `1`                   |
| `agentOwner` | string                               | yes      | —                                                                                             | —                     |

**Responses**

- **Default response (status code not captured)** — Unknown — no response body was observed; no status code or body schema is documented.

### `POST /cloud/api/Manager/getAuthorizations`

> **Evidence — tier B** · sources: `docs/evidence/captures/har/manager-boot-pipeline-proven.redacted.har.json`, `lib/f402_probe.ts` · response not captured

**Boot agent permissions (request observed 2026-11-01; no response schema)**

manager.js:37628 boot permissions and distribution read. The recorded form body is agentID, agentOwner, operation and RRO; the portal assigns the reply to a.INFO and a.DISTRIBUTION. Neither INFO nor DISTRIBUTION fields are published because no capture record holds the response.

- **Tag:** Downline Accounting · **operationId:** `postCloudApiManagerGetAuthorizations`
- **Required capture:** The request is observed in the boot HAR and the call returns 200; only the INFO/DISTRIBUTION envelope keys are missing. Capture one live call and promote it with scripts/apply_captures.ts to upgrade B->A.

**Request body — `application/x-www-form-urlencoded; charset=UTF-8`**

| Field        | Type    | Required | Description                                                          | Example |
| ------------ | ------- | -------- | -------------------------------------------------------------------- | ------- |
| `operation`  | string  | yes      | —                                                                    | —       |
| `agentID`    | string  | yes      | Logged-in account; the observed value was the master agent.          | —       |
| `agentOwner` | string  | yes      | Logged-in account; the observed value was the master agent.          | —       |
| `RRO`        | integer | yes      | Observed in the 2026-11-01 boot HAR. Always 1 in the observed calls. | `1`     |

**Responses**

- **HTTP 200** — HTTP 200 observed in the redacted boot HAR (2026-11-01). The response envelope was not promoted to a hashed capture, so no response schema is published.

### `POST /cloud/api/Manager/getConfigWebReports`

> **Evidence — tier B** · sources: `docs/evidence/captures/har/manager-boot-pipeline-proven.redacted.har.json`, `lib/f402_probe.ts` · response not captured

**Boot web-report configuration (request observed 2026-11-01; no response schema)**

manager.js:35023 boot report-configuration read. The form body is the one the 2026-11-01 boot HAR recorded: agentID, operation, RRO and agentOwner (agentID and agentOwner were the same master account). The portal consumes the reply as an INFO envelope; its keys are not published because no capture record holds them.

- **Tag:** Downline Accounting · **operationId:** `postCloudApiManagerGetConfigWebReports`
- **Required capture:** The request is observed in the boot HAR and the call returns 200; only the response envelope keys are missing. Capture one live call and promote it with scripts/apply_captures.ts to upgrade B->A.

**Request body — `application/x-www-form-urlencoded; charset=UTF-8`**

| Field        | Type    | Required | Description                                                          | Example |
| ------------ | ------- | -------- | -------------------------------------------------------------------- | ------- |
| `operation`  | string  | yes      | —                                                                    | —       |
| `agentID`    | string  | yes      | Logged-in account; the observed value was the master agent.          | —       |
| `RRO`        | integer | yes      | Observed in the 2026-11-01 boot HAR. Always 1 in the observed calls. | `1`     |
| `agentOwner` | string  | yes      | Logged-in account; the observed value was the master agent.          | —       |

**Responses**

- **HTTP 200** — HTTP 200 observed in the redacted boot HAR (2026-11-01). The response envelope was not promoted to a hashed capture, so no response schema is published.

### `POST /cloud/api/Manager/getHistory`

> **Evidence — tier D** · sources: `lib/fantasy402_settlement_ingest.ts:841-851`, `lib/fantasy402_wager_universe_scope.ts:22-31`, `fixture:tests/fixtures/fantasy402-history-poll.json:2-24` · response not captured

**Manager getHistory (wired settlement-history poll; no response capture)**

The only upstream Fantasy402 route in this repository with a real fetch client: resolveHistoryPollUrl builds `${SPORTSDESK_PORTAL_HTTP_BASE}/cloud/api/Manager/getHistory` and pollManagerGetHistory POSTs with no request body (lib/fantasy402_settlement_ingest.ts:841-862). The response must be a JSON array or {data: []} or the poll throws (lib/fantasy402_settlement_ingest.ts:863-881). The request contract (agent scope, date window, auth) is therefore unknown, and row field shapes are not captured; tests/fixtures/fantasy402-history-poll.json is a placeholder shape sample. Surface: surface.manager-getHistory (tier D).

- **Tag:** Settlement History · **operationId:** `postCloudApiManagerGetHistory`
- **Required capture:** Capture one getHistory request/response (redacted) to record the upstream request contract (body/agent scope/date window/auth) and a real response body; this repo only proves the URL, the bodyless POST and the array-or-{data:[]} acceptance.

**Responses**

- **HTTP 200** — JSON array of raw settlement rows, or an object with a data array. Any other shape throws (lib/fantasy402_settlement_ingest.ts:868-881). Row fields are not captured, so only raw/unknown objects are described.
  - content `application/json`: **authored response schema — no response body was captured**
- **Default response (status code not captured)** — Non-2xx status is not captured; the poll throws on !res.ok (lib/fantasy402_settlement_ingest.ts:863-865).

### `POST /cloud/api/Manager/adjustBalance`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:79-89`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Cashier**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerAdjustBalance`
- **Required capture:** Open the 'Cashier' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `customerID`, `amountCents`, `transactionType`, `notes`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1031`, `L-1045`, `L-1058`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/createPlayer`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:91-107`, `main:scripts/portal_tile_crawler.ts:545-670`, `docs/runbooks/operational_guardrails_runbook.md:213` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Add Customer**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerCreatePlayer`
- **Required capture:** Open the 'Add Customer' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `customerID`, `agentID`, `password`, `creditLimit`, `delaySeconds`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1031`, `L-1032`, `L-1040`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/deleteSportsVigSetup`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:173` · response not captured

**Delete sport vig setup**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerDeleteSportsVigSetup`
- **Required capture:** Capture a delete + getSportsVigSetup read-back; confirm the required fields and Result envelope. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/deleteWager`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:193` · response not captured

**Delete a wager**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerDeleteWager`
- **Required capture:** Capture a void/cancel mutation; confirm the request fields (only wagerNumber/reason are documented) and the result envelope. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/gameAdmin`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:57-66`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Game Admin**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGameAdmin`
- **Required capture:** Open the 'Game Admin' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `rotationNumber`, `sportType`, `circleLimit`, `isLocked`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1034`, `L-1052`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/get3rdPartyLimits`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:109-120`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: 3rd Party Limits**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGet3rdPartyLimits`
- **Required capture:** Open the '3rd Party Limits' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `providerID`, `sportCategory`, `maxLimitCents`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1060`, `L-1061`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getAgentTree`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:151-161`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Agent Admin**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetAgentTree`
- **Required capture:** On manager.html (v1.0.280) boot, downline hierarchy is fetched via POST /cloud/api/Manager/getListAgenstByAgent [sic] ({agentID, agentType, operation: "getListAgenstByAgent", RRO: 1} at manager.js:60492) and POST /cloud/api/Manager/getHeriarchy [sic] (manager.js:33074). Capture getListAgenstByAgent and reconcile.

**Extracted DOM inputs (UI observation — not wire parameters):** `masterAgent`, `commissionSplitPercent`, `creditCeiling`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1032`, `L-1070`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getBilling`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:163-172`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Billing**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetBilling`
- **Required capture:** Open the 'Billing' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `billingWeek`, `ratePerActiveHead`, `activeAccountCount`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1050`, `L-1072`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getConfigWebReportsPending`

> **Evidence — tier C** · sources: `lib/f402_probe.ts` · response not captured

**POST /cloud/api/Manager/getConfigWebReportsPending**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetConfigWebReportsPending`
- **Required capture:** No request or response was captured for this operation. Capture one boot call (the parameter set is in MANAGER_BOOT_OPS) and promote it with scripts/apply_captures.ts.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getCustomerNotes`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:130`, `docs/evidence/captures/2026-10-31/getCustomerNotes.post.json` · response not captured

**Read customer notes**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetCustomerNotes`
- **Required capture:** Last observed 500 (0 B) on 2026-10-31 (handler crashed before response serialization). 1. Retrieve upstream server error log for the 500; 2. Re-probe with the identical 2026-10-31 payload to separate deterministic crash from transient failure.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getInfoManager`

> **Evidence — tier C** · sources: `docs/evidence/captures/2026-10-31/getInfoManager.post.json`, `docs/evidence/captures/pending-500s/diagnostics.json` · response not captured

**Manager dashboard header**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetInfoManager`
- **Required capture:** Last observed 500 (0 B) on 2026-10-31. In app/manager/manager.js (v1.0.280, Blob 610B48F7), no getInfoManager operation exists: manager.html boot calls POST /cloud/api/Manager/getAccountInfoOwner (application/json, {agentID, operation}) for accountInfo and POST /cloud/api/Manager/getWeeklyFigureByAgentLite for [data-field="grand-total-weekly"]. Retrieve upstream 500 log or replace with getAccountInfoOwner.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getPending`

> **Evidence — tier C** · sources: `services/simulate_bettor_churn_suite.ts:104-117`, `lib/fantasy402_wager_universe_scope.ts:13-21`, `docs/evidence/captures/pending-500s/diagnostics.json` · response not captured · **contradicted by a concrete artifact**

**Pending wager legs snapshot**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: services/simulate_bettor_churn_suite.ts:104-117 (a consumer type declaration, not a capture). See the RawPendingLeg component; it records the field names only and is not used as a response schema here. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetPending`
- **Required capture:** Prefix-divergent from /cloud/api/Report/Pending (Tier A, 200 41-46 KB). In Manager report bundle (Blob A7FD1C99), Manager/getPending sends form-urlencoded {agentID, type, operation: "getPending", RRO} and reads {LIST, TOTAL}. Re-probe with {agentID, type: "", operation: "getPending", RRO: "1"} or retire in favor of /cloud/api/Report/Pending.
- **Contradiction:** A concrete artifact refutes a claim previously made for this operation; see docs/EVIDENCE.md for the evidence.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getRules`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:174-188`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Rules**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerGetRules`
- **Required capture:** Open the 'Settings &amp; Rules' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `parlayMaxPayout`, `teaserTieRule`, `defaultDelaySeconds`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1040`, `L-1075`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/search`

> **Evidence — tier C** · sources: `docs/runbooks/operational_guardrails_runbook.md:205-209`, `docs/runbooks/operational_guardrails_runbook.md:214` · response not captured · candidate URL+method (not observed on the wire)

**Global account omnisearch**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerSearch`
- **Required capture:** In app/manager/manager.js:49675 (v1.0.280), the omnisearch handler calls POST /cloud/api/Manager/searchCustomerAdmin with {agentID, filter, operation: "searchCustomerAdmin", RRO: 1}. Capture searchCustomerAdmin on the wire and reconcile this candidate_url.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/updateByColumn`

> **Evidence — tier C** · sources: `docs/runbooks/operational_guardrails_runbook.md:215`, `design/domain-branded-types.ts:10,137-155` · response not captured

**Padded-field customer mutation**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: design/domain-branded-types.ts:10,137-155 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerUpdateByColumn`
- **Required capture:** Highest-value mutation capture: one updateByColumn with a safe column (confirmationDelaySeconds) plus the getInfoPlayer read-back. Record exact form fields, content type, padding width actually required (11 vs the observed 10), sub-agent vs master scope, and the Result envelope. Upgrades C->A and is the only way to validate the SILENT_NO_OP / REJECTED_SCOPE claims.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/updateCustomerNotes`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:153` · response not captured

**Update customer notes**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerUpdateCustomerNotes`
- **Required capture:** Capture an append + read-back; confirm the mutation Result envelope and whether notes are immutable. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/vigSetupInsert`

> **Evidence — tier C** · sources: none — authored only · response not captured

**Insert sport vig setup**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiManagerVigSetupInsert`
- **Required capture:** Capture one vigSetupInsert (application/json claimed, 20-char padded sportType) plus getSportsVigSetup read-back; verify content type, padding widths and Result envelope. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/delete-wager`

> **Evidence — tier C** · sources: `docs/runbooks/operational_guardrails_runbook.md:165` · response not captured · candidate URL+method (not observed on the wire)

**Deleted wagers report**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportDeleteWager`
- **Required capture:** UI stage-5 Deleted Wagers action routes to POST /cloud/api/Manager/getReportDeletedTransactions in Blob 96EA5CDA (whereas PendingDelete in report.js:8578 is the read-only Ticket Detail modal lookup). Capture getReportDeletedTransactions and reconcile.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getAnalysis`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:122-132`, `main:scripts/portal_tile_crawler.ts:545-670`, `docs/runbooks/operational_guardrails_runbook.md:166` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Analysis**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetAnalysis`
- **Required capture:** In app/manager/manager.js:93668 (v1.0.280), the Analysis view calls POST /cloud/api/Manager/getReportPlayerAnalysis ({agentID, agentOwner, customerID, reportType, startDate, endDate, lineType, operation: "getReportPlayerAnalysis", RRO: 1}). Capture getReportPlayerAnalysis and reconcile.

**Extracted DOM inputs (UI observation — not wire parameters):** `period`, `sport`, `marketCategory`, `agentID`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1034`, `L-1064`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getDailyFigure`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:225` · response not captured

**Daily figure report**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetDailyFigure`
- **Required capture:** Capture a daily figure read; confirm the request (none is documented) and the row fields. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getDeletedWagerReport`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:213` · response not captured

**Deleted wager report**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetDeletedWagerReport`
- **Required capture:** In the Manager deleted-wagers report bundle (Blob 96EA5CDA), the wire call is POST /cloud/api/Manager/getReportDeletedTransactions. Capture getReportDeletedTransactions and reconcile with /cloud/api/Report/delete-wager.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getFinancialReport`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:190-205`, `main:scripts/portal_tile_crawler.ts:545-670`, `docs/runbooks/operational_guardrails_runbook.md:167` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Transactions History**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetFinancialReport`
- **Required capture:** Open the 'Transactions History' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.

**Extracted DOM inputs (UI observation — not wire parameters):** `customerID`, `startDate`, `endDate`, `transactionFilter`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1031`, `L-1033`, `L-1058`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getGradedWagerByCustomer`

> **Evidence — tier C** · sources: `main:lib/combo_identity.ts:49-67`, `docs/evidence/captures/pending-500s/diagnostics.json` · response not captured

**POST /cloud/api/Report/getGradedWagerByCustomer**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: main:lib/combo_identity.ts:49-67 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetGradedWagerByCustomer`
- **Required capture:** Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 (shared handler threw before response serialization). 1. Retrieve upstream server error log for the shared handler group; 2. Re-probe with the identical captured payload, then test integer week=0 per customer/report/report.js:33171.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getSettledFigure`

> **Evidence — tier C** · sources: `docs/runbooks/operational_guardrails_runbook.md:168` · response not captured · candidate URL+method (not observed on the wire)

**Settled figure / collections**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetSettledFigure`
- **Required capture:** Capture one Collections request/response; verify weekDate format and the 50% split fields. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getTicketDetailPrint`

> **Evidence — tier C** · sources: `main:lib/combo_identity.ts:49-67`, `docs/evidence/captures/pending-500s/diagnostics.json` · response not captured

**POST /cloud/api/Report/getTicketDetailPrint**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. Repo type evidence: main:lib/combo_identity.ts:49-67 (a consumer type declaration, not a capture). The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetTicketDetailPrint`
- **Required capture:** Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 when ticketNumber/wagerNumber were omitted. 1. Retrieve upstream server error log; 2. Re-probe identical payload, then probe with the 5-key customer/report/report.js:108955 envelope {token, ticketNumber, wagerNumber, flag, operation}.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Report/getWeeklyFigure`

> **Evidence — tier C** · sources: `tests/fixtures/portal-left-menu-actions.html` · response not captured

**Weekly figure report**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiReportGetWeeklyFigure`
- **Required capture:** On manager.html (v1.0.280) boot, weekly figures are fetched via POST /cloud/api/Manager/getWeeklyFigureByAgentLite ({agentID, week: 0, type: "A", layout: "byDay", operation: "getWeeklyFigureByAgentLite", RRO: 1} at manager.js:52703) and POST /cloud/api/Manager/getMasterSheet (manager.js:43955). Capture getWeeklyFigureByAgentLite and reconcile.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/System/authenticateCustomer`

> **Evidence — tier C** · sources: `docs/runbooks/operational_guardrails_runbook.md:153` · response not captured

**Authenticate agent/customer session**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiSystemAuthenticateCustomer`
- **Required capture:** Capture one authenticateCustomer POST (redacted credentials): status, Set-Cookie vs body token, response envelope/code field, lifetime, and whether Manager calls then send Authorization or the cookie. Upgrades C->A and validates the whole auth model.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/System/getMessages`

> **Evidence — tier C** · sources: `main:scripts/portal_tile_crawler.ts:68-77`, `main:scripts/portal_tile_crawler.ts:545-670` · response not captured · candidate URL+method (not observed on the wire)

**Launcher tile: Messaging**

UNVERIFIED — no capture exists. The path and method are candidate values inferred from a UI/DOM observation; they were never observed on the wire. The launcher-tile DOM metadata (x-dom-tile, x-dom-selector, x-extracted-inputs) is UI observation only and must not be read as wire parameters. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiSystemGetMessages`
- **Required capture:** On manager.html (v1.0.280) boot, messages are fetched via POST /cloud/api/Manager/getMessage ({acc, type: 0, operation: "getMessage", RRO: 1} at manager.js:55125) and POST /cloud/api/Manager/getNewEmailsCount (manager.js:31845). Capture Manager/getMessage and reconcile this candidate_url.

**Extracted DOM inputs (UI observation — not wire parameters):** `recipientScope`, `subject`, `messageBody`, `priority`. These are DOM form-field names from a launcher tile, not a request schema.

**Observed DOM localization keys (not wire fields):** `L-1055`, `L-1056`.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/System/verifySession`

> **Evidence — tier C** · sources: `scripts/author_openapi_spec.mjs:98` · response not captured

**Verify an existing session**

UNVERIFIED — no capture exists. The path, method and any previously published field schema were authored in the prior hand-built spec or its generators; no request or response artifact exists in this repository. The request body and the response body/status codes are unknown, so no request schema and no response content are published here.

- **Tag:** Inferred (Unverified) · **operationId:** `postCloudApiSystemVerifySession`
- **Required capture:** Capture a verifySession call on a live and an expired token; confirm the response shape and the 401 re-mint behaviour. Upgrades C->A.

**Responses**

- **Default response (status code not captured)** — Unknown — no response was captured, so no status code or body schema is documented.

### `POST /cloud/api/Manager/getBetTicker`

> **Evidence — tier A** · sources: `capture:2026-10-31/getBetTicker.post.json`, `sha256:7812193f3ba148e79626a877a33a7bdadd1bb6aa8ed61b21cb576511126a5f02` · response captured

**Live-captured /cloud/api/Manager/getBetTicker (request template unverified)**

Live-captured contract: 2026-10-31/getBetTicker.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getBetTicker at 2026-10-31T00:19:51.608Z with a 200 response (response body sha256 6476f3f36fde99907c849cc28e3e8ccd7b1b63de43a3f659636c9664054bff5d). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field         | Type   | Required | Description | Example |
| ------------- | ------ | -------- | ----------- | ------- |
| `RRO`         | string | no       | —           | —       |
| `agentID`     | string | no       | —           | —       |
| `agentOwner`  | string | no       | —           | —       |
| `operation`   | string | no       | —           | —       |
| `wagerNumber` | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getBetTicker.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `LIST` (array of object) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Manager/getBetTickerConfig`

> **Evidence — tier A** · sources: `capture:2026-10-31/getBetTickerConfig.post.json`, `sha256:d0bf271bd072308af85c0b857b03aa59a42a338f49f479511b4dbffeef39a0c9` · response captured

**Live-captured /cloud/api/Manager/getBetTickerConfig (request template unverified)**

Live-captured contract: 2026-10-31/getBetTickerConfig.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getBetTickerConfig at 2026-10-31T00:19:51.741Z with a 200 response (response body sha256 8e8fedd17bfabe36c7753dbdf7c5e71f5748adb1fd5b13fe4d8a1993b7ff686e). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getBetTickerConfig.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `INFO` (object) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Manager/getSportsType`

> **Evidence — tier A** · sources: `capture:2026-10-31/getSportsType.post.json`, `sha256:436e1cc17b831c747b322ac900146da22fe229dcaec685f3751ab38b7d92396d` · response captured

**Live-captured /cloud/api/Manager/getSportsType (request template unverified)**

Live-captured contract: 2026-10-31/getSportsType.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getSportsType at 2026-10-31T00:21:29.359Z with a 200 response (response body sha256 105edc9c5766b3d5f0e896d3267286ce404cf2c6ef755a3ed92bcbba3c5f4221). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getSportsType.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `LIST` (array of object) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Manager/getSportsVigSetup`

> **Evidence — tier A** · sources: `capture:2026-10-31/getSportsVigSetup.post.json`, `sha256:061bc4d62e351f56c76cb510d012b2e53e2a1db293806a5b70728725139667b8` · response captured

**Live-captured /cloud/api/Manager/getSportsVigSetup (request template unverified)**

Live-captured contract: 2026-10-31/getSportsVigSetup.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getSportsVigSetup at 2026-10-31T00:19:53.742Z with a 200 response (response body sha256 9e34409b3ae72b41bea2421597ae611453b419fa9ff197ccd09ca6627fb4b677). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-10-31/getSportsVigSetup.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `LIST` (array) — no description
    - `SCHEDULE` (array of object) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Manager/getTransactions`

> **Evidence — tier A** · sources: `capture:2026-11-01/getTransactions.post.json`, `sha256:3de9ac6c0f61a78d131416a0ed8d14e3bed065675b0106f25e53dea97c303ef7` · response captured

**Live-captured /cloud/api/Manager/getTransactions (request template unverified)**

Live-captured contract: 2026-11-01/getTransactions.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Manager/getTransactions at 2026-11-01T02:07:42.209Z with a 200 response (response body sha256 b94c156e0df3642d4283373c789a45ccf6d7e81b9997e44517fa19ff3f09dc9c). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `RRO`        | string | no       | —           | —       |
| `agentID`    | string | no       | —           | —       |
| `agentOwner` | string | no       | —           | —       |
| `customerID` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-11-01/getTransactions.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `LIST` (string) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Report/getDailyFiguresByCustomer`

> **Evidence — tier A** · sources: `capture:2026-11-01/getDailyFiguresByCustomer.post.json`, `sha256:2d93abcd22ea99b329d417e0771c82efa912f80b291cb0b59194726ad3a7a3b6` · response captured

**Live-captured /cloud/api/Report/getDailyFiguresByCustomer (request template unverified)**

Live-captured contract: 2026-11-01/getDailyFiguresByCustomer.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/getDailyFiguresByCustomer at 2026-11-01T04:05:20.098Z with a 200 response (response body sha256 b072a7a032394c3c24182b89587d8881878cb077a6a2690279d3f66eb00e54df). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/json`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `agentID`    | string | no       | —           | —       |
| `customerID` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |
| `week`       | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-11-01/getDailyFiguresByCustomer.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `INFO` (boolean) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Report/getGrading`

> **Evidence — tier A** · sources: `capture:2026-11-01/getGrading.post.json`, `sha256:253af38aeb01e56e32e0db8922efc7ec525cc2aa53f1b345c41be5675483c06c` · response captured

**Live-captured /cloud/api/Report/getGrading (request template unverified)**

Live-captured contract: 2026-11-01/getGrading.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/getGrading at 2026-11-01T02:22:35.993Z with a 200 response (response body sha256 b94c156e0df3642d4283373c789a45ccf6d7e81b9997e44517fa19ff3f09dc9c). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `customerID` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |
| `token`      | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-11-01/getGrading.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `LIST` (string) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Report/Pending`

> **Evidence — tier A** · sources: `capture:2026-11-01/Pending.post.json`, `sha256:719cb5f63fe0123aa26e02a01e4969a7051bc822e1e0fb9de42ea3308896dcc3` · response captured

**Live-captured /cloud/api/Report/Pending (request template unverified)**

Live-captured contract: 2026-11-01/Pending.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/Pending at 2026-11-01T02:22:35.774Z with a 200 response (response body sha256 6c65708478ad70ca3286c68cb0e32e400998d7f4c9fed2f8c614084315e2c277). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field        | Type   | Required | Description | Example |
| ------------ | ------ | -------- | ----------- | ------- |
| `customerID` | string | no       | —           | —       |
| `operation`  | string | no       | —           | —       |
| `token`      | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-11-01/Pending.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `Pending` (array of object) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

### `POST /cloud/api/Report/PendingDelete`

> **Evidence — tier A** · sources: `capture:2026-11-01/PendingDelete.post.json`, `sha256:c1aa1efea5f537c2db2d036c07d9a0423e5f5f1bd9fb53d62ef308cde9aef59e` · response captured

**Live-captured /cloud/api/Report/PendingDelete (request template unverified)**

Live-captured contract: 2026-11-01/PendingDelete.post.json (schemaVersion 1, mode live) recorded POST /cloud/api/Report/PendingDelete at 2026-11-01T04:19:29.720Z with a 200 response (response body sha256 af7ff3397ceee92fbfe8142bbcfee14c72b8cb94adc897af19555235dfbad335). Request and response were captured live with redaction clean (policy v1). The response schema is derived from the captured body skeleton and the request schema from the captured request skeleton; no field values are published. The endpoint path/method were previously inferred (tier C); the live capture now evidences both, while the request field template remains unverified.

- **Tag:** Live-captured (request unverified)

**Request body — `application/x-www-form-urlencoded`**

| Field          | Type   | Required | Description | Example |
| -------------- | ------ | -------- | ----------- | ------- |
| `customerID`   | string | no       | —           | —       |
| `operation`    | string | no       | —           | —       |
| `ticketNumber` | string | no       | —           | —       |
| `token`        | string | no       | —           | —       |

**Responses**

- **HTTP 200** — Captured live 200 response from 2026-11-01/PendingDelete.post.json; schema derived from the captured body skeleton.
  - content `application/json`: **authored response schema — no response body was captured**
    - `Pending` (array) — no description
- **Default response (status code not captured)** — Other status codes were not captured by this record.

## Inferred, unverified operations

These rows are **tier C**. They are authored in the spec/generators, declared from a repo type, or inferred from a UI/DOM observation; none has an observed request or response. They remain in the spec deliberately, labelled — **do not treat any of them as a contract**.

| Method | Path                                            | Why unverified                                                                                                           | Required capture                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| POST   | `/cloud/api/Manager/adjustBalance`              | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | Open the 'Cashier' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                                |
| POST   | `/cloud/api/Manager/createPlayer`               | Inferred only: runbook context only; crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.      | Open the 'Add Customer' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                           |
| POST   | `/cloud/api/Manager/deleteSportsVigSetup`       | Inferred only: generator-authored; no artifact.                                                                          | Capture a delete + getSportsVigSetup read-back; confirm the required fields and Result envelope. Upgrades C->A.                                                                                                                                                                                                                                                                                                           |
| POST   | `/cloud/api/Manager/deleteWager`                | Inferred only: generator-authored; no artifact.                                                                          | Capture a void/cancel mutation; confirm the request fields (only wagerNumber/reason are documented) and the result envelope. Upgrades C->A.                                                                                                                                                                                                                                                                               |
| POST   | `/cloud/api/Manager/gameAdmin`                  | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | Open the 'Game Admin' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                             |
| POST   | `/cloud/api/Manager/get3rdPartyLimits`          | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | Open the '3rd Party Limits' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                       |
| POST   | `/cloud/api/Manager/getAgentTree`               | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | On manager.html (v1.0.280) boot, downline hierarchy is fetched via POST /cloud/api/Manager/getListAgenstByAgent [sic] ({agentID, agentType, operation: "getListAgenstByAgent", RRO: 1} at manager.js:60492) and POST /cloud/api/Manager/getHeriarchy [sic] (manager.js:33074). Capture getListAgenstByAgent and reconcile.                                                                                                |
| POST   | `/cloud/api/Manager/getBilling`                 | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | Open the 'Billing' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                                |
| POST   | `/cloud/api/Manager/getConfigWebReportsPending` | Inferred only: wire observation.                                                                                         | No request or response was captured for this operation. Capture one boot call (the parameter set is in MANAGER_BOOT_OPS) and promote it with scripts/apply_captures.ts.                                                                                                                                                                                                                                                   |
| POST   | `/cloud/api/Manager/getCustomerNotes`           | Inferred only: generator-authored; live capture.                                                                         | Last observed 500 (0 B) on 2026-10-31 (handler crashed before response serialization). 1. Retrieve upstream server error log for the 500; 2. Re-probe with the identical 2026-10-31 payload to separate deterministic crash from transient failure.                                                                                                                                                                       |
| POST   | `/cloud/api/Manager/getInfoManager`             | Inferred only: implementation context only; live capture.                                                                | Last observed 500 (0 B) on 2026-10-31. In app/manager/manager.js (v1.0.280, Blob 610B48F7), no getInfoManager operation exists: manager.html boot calls POST /cloud/api/Manager/getAccountInfoOwner (application/json, {agentID, operation}) for accountInfo and POST /cloud/api/Manager/getWeeklyFigureByAgentLite for [data-field="grand-total-weekly"]. Retrieve upstream 500 log or replace with getAccountInfoOwner. |
| POST   | `/cloud/api/Manager/getPending`                 | Inferred only: implementation context only; a repo TypeScript type only.                                                 | Prefix-divergent from /cloud/api/Report/Pending (Tier A, 200 41-46 KB). In Manager report bundle (Blob A7FD1C99), Manager/getPending sends form-urlencoded {agentID, type, operation: "getPending", RRO} and reads {LIST, TOTAL}. Re-probe with {agentID, type: "", operation: "getPending", RRO: "1"} or retire in favor of /cloud/api/Report/Pending.                                                                   |
| POST   | `/cloud/api/Manager/getRules`                   | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | Open the 'Settings &amp; Rules' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                   |
| POST   | `/cloud/api/Manager/search`                     | Inferred only: absence; a UI/DOM observation only.                                                                       | In app/manager/manager.js:49675 (v1.0.280), the omnisearch handler calls POST /cloud/api/Manager/searchCustomerAdmin with {agentID, filter, operation: "searchCustomerAdmin", RRO: 1}. Capture searchCustomerAdmin on the wire and reconcile this candidate_url.                                                                                                                                                          |
| POST   | `/cloud/api/Manager/updateByColumn`             | Inferred only: absence; a repo TypeScript type only.                                                                     | Highest-value mutation capture: one updateByColumn with a safe column (confirmationDelaySeconds) plus the getInfoPlayer read-back. Record exact form fields, content type, padding width actually required (11 vs the observed 10), sub-agent vs master scope, and the Result envelope. Upgrades C->A and is the only way to validate the SILENT_NO_OP / REJECTED_SCOPE claims.                                           |
| POST   | `/cloud/api/Manager/updateCustomerNotes`        | Inferred only: generator-authored; no artifact.                                                                          | Capture an append + read-back; confirm the mutation Result envelope and whether notes are immutable. Upgrades C->A.                                                                                                                                                                                                                                                                                                       |
| POST   | `/cloud/api/Manager/vigSetupInsert`             | No artifact exists; authored in the spec.                                                                                | Capture one vigSetupInsert (application/json claimed, 20-char padded sportType) plus getSportsVigSetup read-back; verify content type, padding widths and Result envelope. Upgrades C->A.                                                                                                                                                                                                                                 |
| POST   | `/cloud/api/Report/delete-wager`                | Inferred only: a UI/DOM observation only.                                                                                | UI stage-5 Deleted Wagers action routes to POST /cloud/api/Manager/getReportDeletedTransactions in Blob 96EA5CDA (whereas PendingDelete in report.js:8578 is the read-only Ticket Detail modal lookup). Capture getReportDeletedTransactions and reconcile.                                                                                                                                                               |
| POST   | `/cloud/api/Report/getAnalysis`                 | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration; a UI/DOM observation only. | In app/manager/manager.js:93668 (v1.0.280), the Analysis view calls POST /cloud/api/Manager/getReportPlayerAnalysis ({agentID, agentOwner, customerID, reportType, startDate, endDate, lineType, operation: "getReportPlayerAnalysis", RRO: 1}). Capture getReportPlayerAnalysis and reconcile.                                                                                                                           |
| POST   | `/cloud/api/Report/getDailyFigure`              | Inferred only: generator-authored; no artifact.                                                                          | Capture a daily figure read; confirm the request (none is documented) and the row fields. Upgrades C->A.                                                                                                                                                                                                                                                                                                                  |
| POST   | `/cloud/api/Report/getDeletedWagerReport`       | Inferred only: generator-authored; no artifact.                                                                          | In the Manager deleted-wagers report bundle (Blob 96EA5CDA), the wire call is POST /cloud/api/Manager/getReportDeletedTransactions. Capture getReportDeletedTransactions and reconcile with /cloud/api/Report/delete-wager.                                                                                                                                                                                               |
| POST   | `/cloud/api/Report/getFinancialReport`          | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration; a UI/DOM observation only. | Open the 'Transactions History' launcher tile and capture the network request it actually triggers (URL incl. /Manager vs /Report vs another model prefix, method, content type, body, auth) plus a response. Would replace candidate_url with a confirmed URL and upgrade C->A. Do not promote to B on the tile alone.                                                                                                   |
| POST   | `/cloud/api/Report/getGradedWagerByCustomer`    | Inferred only: implementation context only; a repo TypeScript type only.                                                 | Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 (shared handler threw before response serialization). 1. Retrieve upstream server error log for the shared handler group; 2. Re-probe with the identical captured payload, then test integer week=0 per customer/report/report.js:33171.                                                                                                            |
| POST   | `/cloud/api/Report/getSettledFigure`            | Inferred only: a UI/DOM observation only.                                                                                | Capture one Collections request/response; verify weekDate format and the 50% split fields. Upgrades C->A.                                                                                                                                                                                                                                                                                                                 |
| POST   | `/cloud/api/Report/getTicketDetailPrint`        | Inferred only: implementation context only; a repo TypeScript type only.                                                 | Prefix-identical 500 (0 B) on both /Manager and /Report on 2026-11-01 when ticketNumber/wagerNumber were omitted. 1. Retrieve upstream server error log; 2. Re-probe identical payload, then probe with the 5-key customer/report/report.js:108955 envelope {token, ticketNumber, wagerNumber, flag, operation}.                                                                                                          |
| POST   | `/cloud/api/Report/getWeeklyFigure`             | Inferred only: no artifact; a UI/DOM observation only.                                                                   | On manager.html (v1.0.280) boot, weekly figures are fetched via POST /cloud/api/Manager/getWeeklyFigureByAgentLite ({agentID, week: 0, type: "A", layout: "byDay", operation: "getWeeklyFigureByAgentLite", RRO: 1} at manager.js:52703) and POST /cloud/api/Manager/getMasterSheet (manager.js:43955). Capture getWeeklyFigureByAgentLite and reconcile.                                                                 |
| POST   | `/cloud/api/System/authenticateCustomer`        | Inferred only: runbook context only; no artifact.                                                                        | Capture one authenticateCustomer POST (redacted credentials): status, Set-Cookie vs body token, response envelope/code field, lifetime, and whether Manager calls then send Authorization or the cookie. Upgrades C->A and validates the whole auth model.                                                                                                                                                                |
| POST   | `/cloud/api/System/getMessages`                 | Inferred only: crawler behaviour, not a wire observation; a hand-authored UI/DOM declaration.                            | On manager.html (v1.0.280) boot, messages are fetched via POST /cloud/api/Manager/getMessage ({acc, type: 0, operation: "getMessage", RRO: 1} at manager.js:55125) and POST /cloud/api/Manager/getNewEmailsCount (manager.js:31845). Capture Manager/getMessage and reconcile this candidate_url.                                                                                                                         |
| POST   | `/cloud/api/System/verifySession`               | Inferred only: generator-authored.                                                                                       | Capture a verifySession call on a live and an expired token; confirm the response shape and the 401 re-mint behaviour. Upgrades C->A.                                                                                                                                                                                                                                                                                     |

Appendix rows: **29** (tier C in the ledger). The capture plan that would upgrade them is [docs/evidence/capture-requests.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/capture-requests.md).

## Missing surfaces

Real surfaces recorded by the ledger that the final spec does not (or cannot) present as operations. Full inventory: [docs/evidence/surfaces.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/surfaces.md) and [docs/EVIDENCE.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/EVIDENCE.md).

| Surface                                | Tier | Category                   | What it is                                                                                                                          | Detail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | In final spec                                                                                                                                 |
| -------------------------------------- | ---- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `surface.daemon-agent-search`          | D    | local-route                | Agent lookup for the Analysis form (GET /api/agents/search)                                                                         | Case-insensitive prefix-first search over the committed agent tree; used to offer agent suggestions instead of a free-text field that silently accepts typos. Loopback-gated like the tree itself, because agent names are identity data.                                                                                                                                                                                                                                                                                                                                      | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-agent-tree`            | D    | local-route                | Agent hierarchy with wager rollup (GET /api/agent-tree)                                                                             | Serves data/agent-tree.json (2,276 agents, 4 roots) joined with per-agent exposure. Keys are canonical agentLoginKey values; a key owned by more than one AgentID is flagged and never given a level.                                                                                                                                                                                                                                                                                                                                                                          | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-analysis`              | D    | local-route                | Analysis report (GET /api/analysis, /api/analysis/filters, /api/analysis/reports)                                                   | The portal's Analysis report vocabulary and any transcribed result. The filter vocabulary is transcribed from report.js; the report itself is POST /cloud/api/Manager/getAgentPerformance (request observed 2026-11-01, response never captured). A result is served only for the selection it was recorded under, and everything else answers 501 rather than zeroes. The recorded context names the agent the report was run for, so /api/analysis and /api/analysis/reports both carry the PII guard: loopback answers, any other peer must present SPORTSDESK_ADMIN_TOKEN. | yes (5/5 member path(s))                                                                                                                      |
| `surface.daemon-contests`              | D    | local-route                | Contest / futures list (GET /api/contests)                                                                                          | Every contest the sports nav links (data-action=get-games-prop), keyed by the portal's numeric contestNum with sport/market/subject parsed out of the padded type string.                                                                                                                                                                                                                                                                                                                                                                                                      | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-dashboard`             | D    | local-route                | Daemon dashboard routes (GET / and GET /dashboard)                                                                                  | GET / and GET /dashboard serve customer-churn-simulation-dashboard.html as text/html from the Bun daemon.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | yes (13/16 member path(s))                                                                                                                    |
| `surface.daemon-game-admin`            | D    | local-route                | Game Admin exposure (GET /api/game-admin)                                                                                           | Exposure per fixture split by position (Straight/Parlay/Teaser), the report the portal manual v1.0.280 describes in F.A.Q. #4. preGame is computed from gameDateTime and is a fact about the fixture, not a claim about the operator's delete permission.                                                                                                                                                                                                                                                                                                                      | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-game-admin-board`      | D    | local-route                | Game Admin board with per-side exposure (GET /api/game-admin/board)                                                                 | The Admin module of the portal's Game Admin report: each game's spread, moneyline, total and team-total lines with the money on each side. Amounts the portal abbreviates (120k) stay approximate and are excluded from every sum.                                                                                                                                                                                                                                                                                                                                             | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-graph-data-plane`      | D    | local-route                | Graph data plane (feed, companion JSON, assets)                                                                                     | docs/graph.js fetches its data relative to the document, so the generated graph page was dead when served by the daemon. These paths serve it: the live feed at two paths, the two companion JSON files, docs/assets/*, and the dashboard's agent-tree raster.                                                                                                                                                                                                                                                                                                                 | yes (10/15 member path(s))                                                                                                                    |
| `surface.daemon-live-bets`             | D    | local-route                | Live bets v2, frozen v1, and summary (GET /api/v2/live-bets, GET /api/v1/live-bets, GET /api/live-bets, GET /api/live-bets/summary) | Derives a scoreboard payload from captured Report/Pending rows: games, agent rollup, and aggregates computed per request through resolveLiveBets (src/live_bets/resolve.ts). /api/v2/live-bets carries explicit source/fallback/provenance/warnings; /api/v1/live-bets freezes the v1 shape; /api/live-bets answers 308 to /api/v1/live-bets with X-Deprecation. Amounts stay in integer cents; Password/NameFirst/Login are stripped by name.                                                                                                                                 | yes (5/5 member path(s))                                                                                                                      |
| `surface.daemon-live-wagers`           | D    | local-route                | Live wager ticker list (GET /api/live-wagers)                                                                                       | The {LIST: [...]} bet-ticker feed, which is a different shape from Report/Pending: WagerNumber is the ticket id, ShortDesc carries one line per leg, and VolumeAmount can differ from AmountWagered. Both grammars of ShortDesc are parsed; the compact one is flagged. The response also carries the file's own provenance (source, observedAt, captureNote, partial), so a salvaged subset cannot be read as the whole ticker.                                                                                                                                               | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-logo-proxy`            | D    | local-route                | Team-logo proxy (GET /api/logo/{name})                                                                                              | Proxies a team logo from https://cdn.fastassets.io/images/team-logos/ and returns the image bytes with an immutable day-long cache. The name is validated by rejecting separators, control characters and `..` rather than by allowlisting the characters the feed happens to use, so a traversal never reaches the upstream URL. A malformed percent-escape is 400 rather than the 500 it produced before 2026-11-02.                                                                                                                                                         | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-miniapp`               | D    | local-route                | Daemon Telegram Mini App route (GET /miniapp)                                                                                       | GET /miniapp (and /miniapp/) serves telegram-miniapp-dashboard.html for Telegram webview embedding.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | yes (1/2 member path(s))                                                                                                                      |
| `surface.daemon-scoreboard`            | D    | local-route                | Transcribed portal scoreboard (GET /api/scoreboard)                                                                                 | Serves data/scoreboard.json: 22 games (NFL 12, NHL 5, NBA 4, NCAA 1) with scores, status and broadcast, transcribed from the manager page. The pasted logo column was offset, so logos are resolved by team name and fetched through /api/logo/{name}, which decodes them (the upstream content-type was only a claim) and reports their dimensions.                                                                                                                                                                                                                           | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-sport-catalog`         | D    | local-route                | Sport catalog: sub-sports and period menus (GET /api/sports/catalog)                                                                | 19 sports, 230 sub-sports and 42 period entries with the portal's own codes. Period numbers are sport-specific (1 is '1st Half' in Football, '1st Period' in Hockey, '1st 5 Innings' in Baseball), so the type index reports every name a number carries and flags the ambiguous ones.                                                                                                                                                                                                                                                                                         | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-sports-taxonomy`       | D    | local-route                | Sport taxonomy (GET /api/sports)                                                                                                    | The portal's 18 sport categories with counts for the loaded wagers and the scoreboard. All Sports is the absence of a filter and LIVE is a state, so neither is modelled as a category; unmapped sports surface as Other.                                                                                                                                                                                                                                                                                                                                                      | yes (1/1 member path(s))                                                                                                                      |
| `surface.daemon-telegram-admin-routes` | D    | local-route                | Daemon auxiliary routes (webhook, telegram status/activity, preflight, error trigger)                                               | Auxiliary daemon routes: POST /telegram/webhook (Telegram secret-token verified), GET /api/telegram/status, GET /api/telegram/activity?limit=, POST /api/telegram/webhook {action:set\|delete}, OPTIONS preflight 204, GET /api/test/error, GET /api/watchlist and the alert/report dispatchers. All but POST /telegram/webhook (a Telegram-facing callback, not a client contract) and the OPTIONS preflight are published in docs/openapi.json.                                                                                                                              | yes (7/8 member path(s))                                                                                                                      |
| `surface.fantasy402-sport-catalog`     | D    | catalog                    | Fantasy402 sport catalog                                                                                                            | Desk navigation reference: 19 sports, 230 sub-sports, 42 period menus, 2 desk-link collision ids (Arena -> Football + Horse Racing; NCAA Extra -> Basketball + Hockey), 4 provenance digests (subSportTree, periodMenus, collisionRegistry, expectedEmptyPaths). capturedAt 2026-10-21T16:38:53.513Z; periodsCapturedAt 2026-10-30T04:59:14.572Z.                                                                                                                                                                                                                              | no — schemas only, no HTTP path                                                                                                               |
| `surface.gs-manager-cli`               | D    | blocked-contract           | GS Manager CLI surfaces (6 report kinds + 9 jobs subcommands + orchestration commands)                                              | GS Buckeye 2 manager-tools deliverable: 6 UI report kinds (summary, event, player, open-bet, bettor, last-bets), 9 'jobs' subcommands (add, list, run, logs, enable, disable, remove, tick, unlock) plus capabilities, report, serve, docs, cron print. Every upstream contract is blocked_contract; live acquisition is intentionally disabled.                                                                                                                                                                                                                               | no — blocked contract, see [gs-manager-contracts.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/gs-manager-contracts.md) |
| `surface.manager-getGrading`           | D    | upstream-route             | Manager/getGrading (declared settlement feed)                                                                                       | Manager/getGrading - graded-outcome feed declared as a settlement_history slice with ingestionStatus 'wired'; no fetch client exists.                                                                                                                                                                                                                                                                                                                                                                                                                                          | no — not present in the spec                                                                                                                  |
| `surface.manager-getHistory`           | D    | upstream-route             | Manager/getHistory (wired settlement-history poll)                                                                                  | POST {SPORTSDESK_PORTAL_HTTP_BASE}/cloud/api/Manager/getHistory - append-only settlement-history poll; response is an array or {data: []}.                                                                                                                                                                                                                                                                                                                                                                                                                                     | yes (1/1 member path(s))                                                                                                                      |
| `surface.desk-api-unimplemented`       | E    | documented-not-implemented | /api/desk/* routes documented with no implementation                                                                                | 9 spec paths / 10 operations under /api/desk/* (auth session POST+DELETE, auth/me, hitl approve/queue/reject, forensics audit/scores, rfq quote/hedge) have no handler, no HMAC verifier, no CookieMap session code and no queue store anywhere in the repo.                                                                                                                                                                                                                                                                                                                   | no — no implementation exists; removed by design                                                                                              |

4 of 21 ledger surfaces are **not** presented as spec operations; the reason is in the “In final spec” column. The GS report surfaces are documented separately, because no HTTP contract exists for them ([gs-manager-contracts.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/gs-manager-contracts.md)).

## Evidence & limitations

Tier legend: **A** captured request _and_ response · **B** observed request or implementation-verified route (response may be uncaptured) · **C** inferred/authored only · **D** real surface recovered from code/fixtures · **E** documented with no implementation.

Counts below are ledger totals (all recorded rows, including rows removed from the final spec). The last two columns show the release split: ledger surfaces and operations present in the final spec.

| Tier | Meaning                                                                                                                                                                                                             | Ledger surfaces | Spec operations |
| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | --------------- |
| A    | Captured wire contract: a real request AND a real response capture exist. Five operations qualify from the 2026-10-31 live session (getWebLog, getInfoPlayer, getBetTicker, getBetTickerConfig, getSportsVigSetup). |                 | 11              |
| B    | Observed first-party evidence: captured request side, observed request payload, or a route verified against its handler source. The response may still be uncaptured.                                               |                 | 14              |
| C    | Inferred only: authored in the spec/generators, a repo TypeScript type, or a UI/DOM observation. No request or response was observed.                                                                               |                 | 29              |
| D    | Real surface recovered from code or fixtures after being absent from the earlier spec. No captured response; recorded in `surfaces[]` and, for three rows, as a spec operation.                                     | 20              | 49              |
| E    | Documented operation with no implementation in this repository.                                                                                                                                                     | 1               | 0               |

> The ledger distinguishes captured wire evidence from observation and inference: eight operations have live request+response captures — `getWebLog`, `getInfoPlayer`, `getBetTicker`, `getBetTickerConfig` and `getSportsVigSetup` from 2026-10-31, plus `Report/Pending`, `getTransactions` and `getGrading` from 2026-11-01 — and publish capture-derived response schemas. For four of them the captured body is an empty envelope, so the schema describes the envelope and nothing inside it. The Analysis report, `POST /cloud/api/Manager/getAgentPerformance`, has its request observed in full (three calls, 2026-11-01) but no response, and remains tier B. Every other response schema is authored unless its row says otherwise. Earlier wire artifacts are the 2026-10-28 Manager HAR (mode-B request only) and the 2026-10-31 live run, whose three remaining requests (`getPending`, `getInfoManager`, `getCustomerNotes`) returned HTTP 500 with the current request template. Sub-sport lanes and period menus are desk-navigation catalog data, not yet captured live; live pregame sports parity is verified separately (19/19 sports, `getSportsType`). GS Buckeye 2 Partner 118 live acquisition is blocked by design — no endpoint, method, authentication mechanism or response contract for any GS report has been verified, and the observed `getBetReport` payload does not establish a transport. The 11 "Tracked Operational Domains" entries are UI/DOM declarations with candidate URLs and methods, not wire contracts, and the `/api/desk/*` routes are documented without any implementation. Treat any schema or behaviour not backed by a cited capture as a proposal to be confirmed, not as a contract.

**Removed contradicted claim:** 1 ledger row contradicted by a concrete artifact is not an operation in the final spec. The GS extract contradicted the fabricated steam-ingestion route and its partner gateway; that surface is now documented as blocked, without an HTTP contract, in [gs-manager-contracts.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/gs-manager-contracts.md). See [docs/EVIDENCE.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/EVIDENCE.md) for the quotes.

Sources: [docs/openapi.json](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/openapi.json) · [docs/evidence/ledger.json](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/ledger.json) · [docs/EVIDENCE.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/EVIDENCE.md) · [docs/evidence/capture-requests.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/capture-requests.md) · [docs/evidence/surfaces.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/evidence/surfaces.md) · [docs/gs-manager-contracts.md](https://github.com/bw496915-cmyk/Sports-desk-ops/blob/main/docs/gs-manager-contracts.md).
