Skip to main content
PATCH
Update thesis status

Path Parameters

thesis_id
string<uuid>
required

Body

application/json

Request body for updating thesis status.

status
enum<string>
required

Thesis lifecycle status.

Available options:
active,
invalidated,
expired,
realized
reason
string | null
Maximum string length: 500

Response

Successful Response

Full thesis model for API responses.

thesis_id
string<uuid>
required
created_at
string<date-time>
required
status
enum<string>
required

Thesis lifecycle status.

Available options:
active,
invalidated,
expired,
realized
direction
enum<string>
required
Available options:
bullish,
bearish,
neutral
timeframe
enum<string>
required
Available options:
intraday,
swing,
position
narrative
string
required

1-2 sentence human-readable thesis

sectors
string[]
required

Ranked by thesis fit

confidence
number
required

Thesis-specific conviction 0-1

Required range: 0 <= x <= 1
source
enum<string>
required
Available options:
ai_generated,
user_defined,
debate_derived,
news_derived
valid_until
string<date-time>
required

Auto-set based on timeframe

regime_dominant
string | null

V5 dominant state at creation

regime_confidence
number | null

V5 Shannon entropy confidence (0-100)

regime_vector
Regime Vector · object | null

Full 6-state probabilities (for audit)

vix_regime
string | null

VIX regime label at creation

day_type
string | null

Day classification at creation

catalysts
string[]
invalidation_conditions
string[]
catalyst_ids
string[]

Structured catalyst IDs

risk_ids
string[]

Structured risk IDs

debate_id
string<uuid> | null
macro_event_id
string | null

Driving MacroEvent (graph event_id)

symbols
string[]
regime_drifted
boolean
default:false

True if current regime differs from thesis regime