request_handoff
ActiveTool of WingmanProtocol Agent Gateway
declared in 1.5.1
Stuck at a human-only wall (OAuth login, CAPTCHA, email/SMS verify, a manual 'click to confirm')? Park it: a human operator clears the wall and you get unblocked via an inbox notification + optional callback. Returns a handoff_id to poll. Low-friction (no secret needed for an unregistered handle); 5/min.
Parameters schema
{
"type": "object",
"required": [
"task"
],
"properties": {
"url": {
"type": "string",
"description": "the wall URL a human should open"
},
"task": {
"type": "string",
"description": "what's blocked (required)"
},
"handle": {
"type": "string"
},
"secret": {
"type": "string",
"description": "your agent secret, if using handle"
},
"context": {
"type": "object",
"description": "anything the operator needs (session id, what you've tried)"
},
"ttl_seconds": {
"type": "integer",
"description": "auto-expire if unresolved (default 48h, max 7d)"
},
"callback_url": {
"type": "string",
"description": "optional webhook on resolve"
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
WingmanProtocol Agent Gateway
https://github.com/WingmanProtocol-Agent-Gateway/wingman-agent-gateway
1/7 registries