---
title: "Review Example"
method: POST
path: "/examples/{example_key}/review"
tags: ["examples"]
---

# Review Example

`POST /examples/{example_key}/review`

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

## Path parameters

- `example_key` string, required

## Request body

- ExampleReviewIn
  - `entity_id` string, required
  - `version` integer, required
  - `through` string, date-time, required

## Response `200`

Successful Response

- LivingExampleSummary
  - `example_key` string, required
  - `subject_type` string, required
  - `entity_id` string, required
  - `version` integer, required
  - `ticker` string, nullable, required
  - `title` string, required
  - `statement` string, required
  - `coverage_state` string, required
  - `checked_at` string, date-time, nullable, required
  - `coverage` ExampleCoverage
    - `policy_version` 'living-example-coverage/v1'
    - `primary` ExampleCoverageDomain, required
      - `state` 'pending' | 'current' | 'behind' | 'budget_delayed' | 'needs_attention' | 'withdrawn' | 'unavailable', required
      - `since` string, date-time, required
      - `through` string, date-time, required
      - `pending_count` integer, required
      - `held_count` integer, required
      - `review_needed_count` integer
    - `live_news` ExampleCoverageDomain, required
      - `state` 'pending' | 'current' | 'behind' | 'budget_delayed' | 'needs_attention' | 'withdrawn' | 'unavailable', required
      - `since` string, date-time, required
      - `through` string, date-time, required
      - `pending_count` integer, required
      - `held_count` integer, required
      - `review_needed_count` integer
    - `historical_news` ExampleCoverageDomain, required
      - `state` 'pending' | 'current' | 'behind' | 'budget_delayed' | 'needs_attention' | 'withdrawn' | 'unavailable', required
      - `since` string, date-time, required
      - `through` string, date-time, required
      - `pending_count` integer, required
      - `held_count` integer, required
      - `review_needed_count` integer
  - `live_coverage_state` string, nullable
  - `review_needed_count` integer
  - `reviewed_through` string, date-time, nullable, required
  - `unread_count` integer, required
  - `events` LivingExampleEvent[], required
    - `event_title` string, required
    - `event_summary` string, required
    - `thesis_effect` 'strengthens' | 'weakens' | 'breaks' | 'mixed' | 'unrelated' | 'uncertain', required
    - `why_it_matters` string, required
    - `conclusion` string, required
    - `uncertainty` string, required
    - `next_checkpoint` string, required
    - `factors` ExampleFactor[], required
      - `factor_statement` string, required
      - `factor_kind` 'claim' | 'expectation' | 'invalidation', required
      - `effect` 'strengthens' | 'weakens' | 'breaks' | 'mixed' | 'unrelated' | 'uncertain', required
      - `reasoning` string, required
      - `evidence_scope` 'company' | 'theme', nullable
    - `evidence` ExampleSource[], required
      - `title` string, required
      - `publisher` string, required
      - `source_url` string, required
      - `published_at` string, date-time, required
    - `delivery_eligible` boolean
    - `evaluation_context_policy` string, nullable
    - `evidence_review_policy` string, nullable
    - `evidence_scope` 'company' | 'theme', nullable
    - `id` integer, required
    - `example_key` string, required
    - `subject_type` 'company' | 'theme', required
    - `entity_id` string, required
    - `version` integer, required
    - `ticker` string, nullable, required
    - `title` string, required
    - `statement` string, required
    - `source_key` string, required
    - `occurred_at` string, date-time, required
    - `evaluated_at` string, date-time, required
    - `recorded_at` string, date-time, required
    - `is_backfill` boolean, required
    - `correction` ExampleEventCorrection
      - `original_event_id` integer, required
      - `reason` string, required
      - `corrected_at` string, date-time, 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)