---
title: "Suggest Shared Thesis Links"
method: GET
path: "/shared-theses/{shared_thesis_id}/link-suggestions"
tags: ["shared theses"]
---

# Suggest Shared Thesis Links

`GET /shared-theses/{shared_thesis_id}/link-suggestions`

## 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/{shared_thesis_id}/link-suggestions`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Suggest companies to review for a theme; never infer an investment conclusion.

Companies found in TickerTrac's retained filings come first, each with the exact
passage and filing that surfaced it (see ``theme_company_suggestions``). Tracked
companies follow, ranked locally by overlap with the investor's own context. Neither
makes a model or provider call. Direction remains ``uncertain`` until the user
reviews it, and an untracked suggestion must be tracked before it can be linked.

## Path parameters

- `shared_thesis_id` integer, required

## Response `200`

Successful Response

- SharedThesisLinkSuggestionOut[]
  - `ticker` string, required
  - `company_name` string, required
  - `effect` 'tailwind' | 'headwind' | 'mixed' | 'uncertain', required
  - `rationale` string, nullable, required
  - `tracked` boolean
  - `evidence_excerpt` string, nullable
  - `evidence_source` string, nullable
  - `evidence_url` string, nullable

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