Skip to main content
POST
Mine pair proposals

Authorizations

Authorization
string
header
required

Either a Supabase user access token (from a password login, or the passwordless magic-link flow) or a long-lived forge_sk_… API key. Both are sent as Authorization: Bearer <value> and resolve to the same owner, so every endpoint accepts either. Session tokens expire in ~1h; API keys do not expire and are the credential for MCP clients, CI, and partner integrations.

Path Parameters

campaign_id
string
required

Body

application/json
div_band
number[] | null

[lo, hi] divergence band (degrees) overriding the engine default.

Required array length: 2 elements
n
integer
default:24

How many proposals to mine.

max_per_head
integer | null

Cap on pairs sharing one head episode.

max_per_tail
integer | null

Cap on pairs sharing one tail episode.

Response

The mined proposals

proposals
object[]
head_stats
object

The cumulative per-head yield the mining was seeded with.