---
title: "Run Confirmed Thesis Ask"
method: POST
path: "/thesis-commands/ask-stream"
tags: ["thesis commands"]
---

# Run Confirmed Thesis Ask

`POST /thesis-commands/ask-stream`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/thesis-commands/ask-stream`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Run one confirmed Ask and bind completion to immutable Ask History.

Unlike Replay, Ask remains a tab-bound stream. The receipt makes retries safe and
lets a lost completed response replay its saved history, but a failed or abandoned
generation is not silently restarted because the question allowance was already
reserved.

## Request body

- ThesisAskConfirmationIn: One explicit confirmation before a single tab-bound Ask execution.
  - `schema_version` 'thesis-ask-confirmation-v1', required
  - `idempotency_key` string, uuid, required
  - `proposal_idempotency_key` string, uuid, required
  - `operation` 'run_ask', required
  - `confirmation_policy` 'explicit_approval_required', required
  - `confirmation_statement` 'I confirm TickerTrac may reserve one question from the monthly allowance to answer this exact question from retained SEC filings and earnings calls.', required
  - `requested_window` 'retained_company_evidence', required
  - `source_scope` 'all', required
  - `transcript_section` 'all', required
  - `speaker_role` 'all', required
  - `top_k` 5, required
  - `subject_type` 'company_thesis', required
  - `subject_version` integer, required
  - `watchlist_id` integer, required
  - `ticker` string, required
  - `question` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)