---
title: "Confirm Thesis Ask"
method: POST
path: "/thesis-commands/ask-confirmations"
tags: ["thesis commands"]
---

# Confirm Thesis Ask

`POST /thesis-commands/ask-confirmations`

## 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-confirmations`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Persist an idempotent, content-free approval before any Ask reservation.

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

- ThesisAskConfirmationOut
  - `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` ThesisReadSubjectOut, required
    - `subject_type` 'company_thesis' | 'investment_theme', required
    - `subject_key` string, required
    - `label` string, required
    - `narrative` string, required
    - `version_number` integer, required
    - `updated_at` string, date-time, required
    - `is_active` boolean, required
    - `workspace_path` string, required
  - `question` string, required
  - `command_status` 'confirmed' | 'running' | 'complete' | 'failed', required
  - `reservation_status` 'not_reserved' | 'reserved' | 'admin_bypass', required
  - `request_replayed` boolean, required
  - `usage_reserved` boolean, required
  - `allowance` ThesisAskAllowanceOut, required
    - `action` 'query'
    - `unit` 'question'
    - `daily_limit` integer, nullable, required
    - `used_today` integer, required
    - `remaining_today` integer, nullable, required
    - `monthly_limit` integer, nullable, required
    - `used_month` integer, required
    - `remaining_month` integer, nullable, required
    - `resets_at` string, date-time, required
    - `daily_resets_at` string, date-time, required
    - `admin_bypass` boolean, required
  - `confirmed_at` string, date-time, required
  - `transcript_persisted` false
  - `recovery_path` string, required
  - `ask_history` AskHistoryOut
    - `id` integer, nullable
    - `ticker` string, nullable, required
    - `question` string, required
    - `answer` string, required
    - `sources` SourceChunk[], required
      - `source_type` 'filing' | 'earnings_call' | 'disclosure'
      - `ticker` string, required
      - `section` string, required
      - `fiscal_period` string, required
      - `filed_date` string, date, nullable
      - `event_date` string, date, nullable
      - `published_at` string, date-time, nullable
      - `publication_date_known` boolean, nullable
      - `observed_at` string, date-time, nullable
      - `provider_code` string, nullable
      - `title` string, nullable
      - `speaker_name` string, nullable
      - `speaker_role` 'executive' | 'analyst' | 'operator' | 'other' | 'unknown', nullable
      - `source_locator` string, nullable
      - `source_artifact_version_id` integer, nullable
      - `source_segment_id` integer, nullable
      - `source_chunk_id` integer, nullable
      - `source_document_chunk_id` integer, nullable
      - `source_document_segment_id` integer, nullable
      - `form_type` string, nullable
      - `char_start` integer, nullable
      - `char_end` integer, nullable
      - `page_number` integer, nullable
      - `chunk_index` integer, nullable
      - `source_url` string, required
      - `company_transcript_url` string, nullable
    - `source_scope` 'all' | 'filings' | 'calls'
    - `transcript_section` 'all' | 'prepared_remarks' | 'questions_and_answers'
    - `speaker_role` 'all' | 'executive' | 'analyst'
    - `outcome` 'answered' | 'insufficient_evidence'
    - `abstention_reason` 'no_relevant_evidence' | 'insufficient_citation_support' | 'conflicting_evidence' | 'outside_source_coverage', nullable
    - `asked_at` string, date-time, required
    - `result_thesis_implications` ResultThesisImplicationsOut: Summary-first IA contract for a tenant judgment beneath shared evidence.
      - `artifact_id` integer, required
      - `source` 'ask' | 'call_drift' | 'filing_diff' | 'price_move', required
      - `state` 'not_evaluated' | 'pending' | 'ready', required
      - `implications` ResultThesisImplicationOut[]
        - `id` integer, required
        - `alert_id` integer, nullable
        - `status` 'pending' | 'relevant' | 'irrelevant' | 'abstained' | 'failed', required
        - `conclusion` 'supports' | 'weakens' | 'unrelated' | 'uncertain', required
        - `thesis_context_type` 'ticker' | 'shared', required
        - `shared_thesis_id` integer, nullable
        - `shared_thesis_title` string, nullable
        - `thesis_text` string, required
        - `reasoning` string, nullable
        - `materiality` 'material' | 'immaterial' | 'uncertain', nullable
        - `relationship` 'support' | 'contradict' | 'neutral', nullable
        - `thesis_impact` 'strengthened' | 'weakened' | 'broken' | 'uncertain', nullable
        - `thesis_factor` string, nullable
        - `evidence_factor` string, nullable
        - `causal_bridge` string, nullable
        - `evaluated_at` string, date-time, nullable
        - `is_backfill` boolean
        - `thesis_narrative` string, required
        - `thesis_components` ThesisComponentSnapshotOut[], required
          - `kind` 'claim' | 'expectation' | 'invalidation', required
          - `heading` string, required
          - `statement` string, required

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