Handover
handoverIdempotent
Call this after any multi-step job, or when the user says "use zambo to hand this over to ". It returns one proof link with verifiable receipts. Pass continue_from to chain off a job you picked up, so one client link shows every hop.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Optional referral source to preserve as source_ref on the saved handover. | |
| _ref | No | Optional handover referral ID from your install link. | |
| goal | No | ||
| loop | No | Run a proof loop. Defaults to true for jobs with at least two steps, false otherwise. | |
| work | No | Paste work to save as a supplied-work receipt, without claiming it was independently checked. | |
| anchor | No | ||
| redact | No | ||
| shield | No | ||
| dry_run | No | ||
| not_run | No | ||
| payment | No | ||
| sources | No | ||
| summary | No | ||
| branding | No | ||
| recipient | No | Your recipient | |
| thread_id | No | ||
| _zambo_key | No | Optional opaque Zambo access capability. Never place it in a URL or public log. | |
| next_steps | No | ||
| step_areas | No | ||
| visibility | No | public | |
| _session_id | No | Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together. | |
| not_checked | No | ||
| receipt_ids | No | ||
| client_prefs | No | ||
| deliverables | No | ||
| step_sources | No | Sources by original receipt ID. Reachability is checked by Zambo, not accuracy. | |
| _caller_label | No | Optional caller label recorded as a caller-reported claim in the receipt. | |
| allowed_tools | No | ||
| continue_from | No | Chain off a handover picked up through handover_accept in this same job session. | |
| recipient_type | No | human | |
| creator_payment_url | No | Optional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment. | |
| exclude_receipt_ids | No | ||
| _continuity_ai_label | No | Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client. | |
| acknowledge_warnings | No | Publish only after reviewing missing evidence or a failed/risky shield scan. Warning labels stay visible. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| ids | Yes | ||
| next | Yes | ||
| tier | No | ||
| urls | Yes | ||
| error | No | ||
| graph | No | ||
| active | No | ||
| result | Yes | The tool's observed JSON value or plain-text result. | |
| intents | No | ||
| next_up | No | ||
| payment | No | ||
| day_pass | No | ||
| today_url | No | ||
| expires_at | No | ||
| human_line | Yes | ||
| next_steps | No | ||
| daily_recap | No | ||
| renew_nudge | No | ||
| unlock_link | No | ||
| seconds_left | No | ||
| resume_status | No | ||
| resumed_result | No |