Skip to main content
GET
Get seed

Path Parameters

seed_id
string
required

Response

Seed record

Response shape for a single seed row.

A thin projection over :class:StorySeedRecord - JSONB columns surface as dict so dashboards can render them without a second round-trip; large list views can slim this down later if needed.

seed_id
string<uuid>
required
tenant_id
string<uuid>
required
slug
string | null
required
state
enum<string>
required

The 6 seed lifecycle states.

Source: mechanics/lifecycle-state-machine.md §1 - wire-form values match the DB CHECK (state IN ('raw',...)) exactly.

Available options:
raw,
triaged,
promoted,
used,
rejected,
dead
state_changed_at
string<date-time>
required
promoted_project_id
string | null
required
triaged_by
string<uuid> | null
required
triage_note
string | null
required
dramatic_premise
string
required
dramatic_situation
string
required
central_tension
Central Tension · object
required
human_tension_grounding
Human Tension Grounding · object
required
protagonist_shape
Protagonist Shape · object
required
stakes
Stakes · object
required
tone
string
required
pack_affinity
Pack Affinity · object[]
required
provenance_class
enum<string>
required

Discrete provenance vocabulary (5 values) per R4 R127-C1.

Source of truth:

  • docs/design/concepts/green-source-scout/mechanics/provenance-contract.md §2
  • docs/design/concepts/seed-lifecycle-store/mechanics/schema.md (CHECK constraint)
  • docs/design/concepts/story-seed-object/design.md §3.1

Notable absence: there is NO scraped value - the gate enforces by absence. The DB-level CHECK constraint lists exactly these five.

Available options:
generated,
public-domain,
licensed,
opt-in,
operator-inspired
risk_flags
enum<string>[]
required

Controlled risk-flag vocabulary (C-SSD-7 contract §2).

ANY flag set on a seed → mandatory human review (cannot auto-promote). Stored as TEXT[] with a GIN index so the SC8 audit (WHERE risk_flags @> ARRAY[...]) is a single index scan.

Source: docs/design/concepts/green-source-scout/mechanics/provenance-contract.md §2.

Available options:
pii-present,
sensitive-data,
identifiable-real-event,
copyrighted-phrasing-detected,
platform-restriction,
minor-or-sensitive-subject
provenance
Provenance · object
required
quality_scores
Quality Scores · object | null
required
durability_class
string
required
freshness_ts
string<date-time> | null
required
stale_after
string<date-time> | null
required
resonance_score
number
required
created_at
string<date-time>
required
updated_at
string<date-time>
required