Merge into

curl -X POST https://api.podflare.ai/v1/sandboxes/$PARENT/merge_into/$WINNER

parent.merge_into(winner)
# parent.id still works, now drives winner's VM.
# winner.close() is a no-op afterward (marked defunct).

await parent.mergeInto(winner);
// parent.id still works; winner is defunct.

​

What actually happens

• parent.id is still a valid sandbox id, but it now drives the winner’s underlying VM.
• winner.id is no longer a live sandbox. The SDK flags the winner object so its close() becomes a no-op (prevents double-destroy).
• Siblings are NOT touched. If you forked n=5 and one is the winner, the other 4 are still alive — the caller destroys them explicitly.

​

Idempotency

• Merging the same winner twice: second call returns 404 (winner id gone after first merge).
• Merging a sandbox into itself: 400.

​

Typical pattern

children = parent.fork(n=5)
try:
    results = [c.run_code(plan) for c, plan in zip(children, plans)]
    winner = children[pick_best_index(results)]
    parent.merge_into(winner)
finally:
    for c in children:
        if c is not winner:
            c.close()