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

# Propose Thesis Ask

`POST /thesis-commands/ask-proposals`

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

Review one exact question without reserving allowance or calling a provider.

## Request body

- ThesisAskProposalIn: One read-only preflight for a question over retained company evidence.
  - `schema_version` 'thesis-ask-proposal-v1', required
  - `idempotency_key` string, uuid, required
  - `operation` 'propose_ask', required
  - `confirmation_policy` 'explicit_approval_required', 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' | 'investment_theme', required
  - `subject_version` integer, required
  - `watchlist_id` integer, nullable
  - `ticker` string, nullable
  - `shared_thesis_id` integer, nullable
  - `question` string, required

## Response `200`

Successful Response

- ThesisAskProposalOut
  - `schema_version` 'thesis-ask-proposal-v1', required
  - `idempotency_key` string, uuid, required
  - `operation` 'propose_ask', required
  - `confirmation_policy` 'explicit_approval_required', required
  - `requested_window` 'retained_company_evidence', required
  - `source_scope` 'all', required
  - `transcript_section` 'all', required
  - `speaker_role` 'all', required
  - `top_k` 5, required
  - `proposal_status` 'confirmation_available' | 'theme_not_supported' | 'allowance_exhausted', required
  - `approval_available` boolean, 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
  - `generated_at` string, date-time, 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
  - `usage_reserved` false
  - `provider_calls` 0
  - `model_calls` 0
  - `transcript_persisted` false
  - `recovery_path` 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)