---
title: "Create Shared Thesis"
method: POST
path: "/shared-theses"
tags: ["shared theses"]
---

# Create Shared Thesis

`POST /shared-theses`

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

## Request body

- SharedThesisSaveIn
  - `components` ThesisComponentIn[]
    - `id` integer, nullable
    - `kind` 'claim' | 'expectation' | 'invalidation', required
    - `statement` string, required
  - `title` string, required
  - `thesis_text` string, required
  - `preset_key` string, nullable

## Response `201`

Successful Response

- SharedThesisOut
  - `id` integer, required
  - `title` string, required
  - `thesis_text` string, required
  - `preset_key` string, nullable, required
  - `is_active` boolean, required
  - `monitoring_eligible` boolean
  - `archived_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `components` ThesisComponentOut[]
    - `id` integer, required
    - `kind` 'claim' | 'expectation' | 'invalidation', required
    - `statement` string, required
    - `position` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `links` SharedThesisLinkOut[]
    - `id` integer, required
    - `security_id` integer, required
    - `ticker` string, required
    - `company_name` string, required
    - `effect` 'tailwind' | 'headwind' | 'mixed' | 'uncertain', required
    - `rationale` string, nullable, required
    - `notifications_muted` boolean, required
    - `monitoring_eligible` boolean
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `version_count` integer, required
  - `is_testable` 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)