Agent OS Owner Control

Create a signed owner pickup handoff

Creates an expiring signed pickup token for approval, ask-owner, budget, receipt, failure, listing draft, memory candidate, or canary events. The token can only perform the allowed actions and never triggers raw execute/invoke or wallet transfer.

post/agent-os/deployments/{deployment_id}/handover

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/agent-os/deployments/{deployment_id}/handover
  • Auth: HTTP bearer

Path parameters

deployment_idstring required

Request body

channel_idstring
event_type'approval_required' | 'ask_owner' | 'budget_alert' | 'receipt_ready' | 'run_failed' | 'listing_draft_ready' | 'memory_candidate_ready' | 'canary_result_ready'
run_idstring
approval_idstring
receipt_idstring
titlestring
summarystring
payloadobject
session_stateobject
allowed_actionsstring[]
ttl_secondsinteger

Response

Handoff event and signed pickup token created

Changes

No recorded changes to this operation across all 1 revision of this API.