Skip to main content
GET
List seeds

Query Parameters

lifecycle_state
enum<string> | null

Filter by lifecycle state (e.g. triaged, promoted). 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
provenance_class
enum<string> | null

Filter by provenance class. 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
search
string | null

Free-text substring match against dramatic_premise / dramatic_situation (case-insensitive).

Required string length: 1 - 120
limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

Paginated seed list

Paginated list response.

seeds
SeedResponse · object[]
required
limit
integer
required
offset
integer
required
count
integer
required