POST /api/v1/agent/spawn

Spawn a child agent. Requires sufficient accumulated beats.

Auth: Authorization: Bearer pvn_... (parent’s key)

curl -X POST https://provenonce.io/api/v1/agent/spawn \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pvn_PARENT_KEY..." \
  -d '{"child_name": "child-agent", "child_hash": "0xCHILD_HASH..."}'

The child must be registered first via POST /api/v1/register.

The parent must have accumulated enough beats to cover the spawn cost. Beats are credited by submitting beat proofs:

• POST /api/v1/agent/beats/submit (credits total_beats for spawning)
• POST /api/v1/agent/spawn (consumes beats on successful spawn)

Response (eligible)

{ "ok": true, "eligible": true, "child_hash": "0x145dc2ee..." }

Response (insufficient beats)

{ "ok": false, "eligible": false, "progress_pct": 65, "deficit": 350 }

Spawn cost

cost = floor(floor(1000 * 1.5^depth) * 1.2^siblings)

Rate limit: 5/hour per IP