---
title: "Create Thesis Baseline"
method: POST
path: "/watchlists/{watchlist_id}/theses/{ticker}/baseline"
tags: ["thesis baselines"]
---

# Create Thesis Baseline

`POST /watchlists/{watchlist_id}/theses/{ticker}/baseline`

## 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/watchlists/{watchlist_id}/theses/{ticker}/baseline`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Return the cached baseline for this thesis text or build it once.

The cache identity includes the full text hash and prompt version. Editing the
thesis creates a new assessment; reloading the page does not create model spend.

## Path parameters

- `watchlist_id` integer, required
- `ticker` string, required

## Response `200`

Successful Response

- ThesisBaselineOut
  - `id` integer, required
  - `ticker` string, required
  - `thesis_text` string, required
  - `assessment` 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
  - `model` string, required
  - `prompt_version` string, required
  - `generated_at` string, date-time, required
  - `monitoring_active` boolean, 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)
