---
title: "Create Theme Interview"
method: POST
path: "/theme-interviews"
tags: ["theme-interviews"]
---

# Create Theme Interview

`POST /theme-interviews`

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

## Request body

- ThemeInterviewStartIn
  - `watchlist_id` integer, required
  - `title` string, required

## Response `201`

Successful Response

- ThemeInterviewSessionOut
  - `session_id` integer, required
  - `watchlist_id` integer, required
  - `title` string, required
  - `status` string, required
  - `model_turns_used` integer, required
  - `max_model_turns` integer, required
  - `summary` string, required
  - `next_target` ThemeInterviewTarget, required
    - `kind` 'theme' | 'company', required
    - `company_id` integer, nullable
  - `next_question` string, nullable, required
  - `ready_for_review` boolean, required
  - `statements` ThemeInterviewStatementOut[], required
    - `statement_id` string, required
    - `kind` string, required
    - `text` string, required
    - `is_paraphrase` boolean, required
    - `quotes` string[], required
  - `companies` ThemeInterviewCompanyOut[], required
    - `company_id` integer, required
    - `security_id` integer, required
    - `ticker` string, required
    - `company_name` string, required
    - `status` string, required
    - `model_turns_used` integer, required
    - `max_model_turns` integer, required
    - `relationship` ThemeInterviewRelationshipOut
      - `relationship_id` string, required
      - `company_id` integer, required
      - `effect` 'tailwind' | 'headwind' | 'mixed' | 'uncertain', required
      - `rationale` string, required
      - `is_paraphrase` boolean, required
      - `quotes` string[], required
  - `ambiguities` ThemeInterviewAmbiguityOut[], required
    - `ambiguity_id` string, required
    - `target` ThemeInterviewTarget, required
      - `kind` 'theme' | 'company', required
      - `company_id` integer, nullable
    - `question` string, required
  - `turns` ThemeInterviewTurnOut[]
    - `role` 'user' | 'assistant', required
    - `text` string, required
    - `company_id` integer, nullable
  - `last_rejection_code` 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)