POST /api/zeq/agent/operators/promote

When a derived operator (from /operators/derive) survives 100+ uses with ≥99% fitness, the agent can submit it for promotion into the canonical operator catalogue. Foundation review is required — the promotion writes a pending_promotion row, and a foundation admin manually flips the gate.

Auth

Authorization: Bearer zeq_ak_…. Foundation account approves; anyone with admin+ on the proposing chain can submit.

Cost

0 ZEQ. Free — submission only. The gate-flip is a foundation write, not a chargeable action.

Request

curl -X POST https://YOUR-FRAMEWORK/api/zeq/agent/operators/promote \
  -H "Authorization: Bearer zeq_ak_..." \
  -H "Content-Type: application/json" \
  -d '{
    "operator_id":       "op_2026-05-10T13:08:32Z_...",
    "promotion_notes":   "104 successful uses across 9 chains, 99.7% fitness mean"
  }'

Response · 200 OK

{
  "ok": true,
  "promotion_id": "promo_...",
  "status":       "pending_review",
  "estimated_review_time": "1-7 days"
}

Errors

Status	Code	Cause
404	operator_not_found	Bad ID.
412	criterion_not_met	< 100 uses or < 99% fitness mean.
409	already_pending	Existing pending review row.