{"components":{"schemas":{"ApproveHandoffRequest":{"properties":{"notes":{"type":"string"}},"type":"object"},"ClaimHandoffRequest":{"properties":{"claimToken":{"type":"string"},"solverEmail":{"type":"string"},"solverName":{"type":"string"}},"type":"object"},"CompleteHandoffRequest":{"properties":{"artifacts":{"items":{"type":"string"},"type":"array"},"result":{"type":"string"},"solverId":{"type":"string"}},"required":["result"],"type":"object"},"CreateHandoffRequest":{"properties":{"acceptanceCriteria":{"type":"string"},"agentId":{"type":"string"},"bounty":{"properties":{"amount":{"type":"number"},"currency":{"default":"USD","type":"string"}},"type":"object"},"bounty_usd":{"type":"number"},"callbackUrl":{"format":"uri","type":"string"},"externalId":{"type":"string"},"instructions":{"type":"string"},"metadata":{"type":"object"},"provider":{"enum":["browserbase","daytona","custom"],"type":"string"},"taskTimeoutSeconds":{"description":"CamelCase alias for task_timeout_seconds.","type":"integer"},"task_timeout_seconds":{"default":1800,"description":"Reservation timeout in seconds before a reserved live workspace is reopened for another solver. Defaults to 1800 seconds.","type":"integer"},"timeoutSeconds":{"description":"Alias for task_timeout_seconds.","type":"integer"},"title":{"type":"string"},"tool":{"const":"handoff_to_human","type":"string"},"workspaceUrl":{"format":"uri","type":"string"}},"required":["workspaceUrl","title","instructions","bounty"],"type":"object"},"RejectHandoffRequest":{"properties":{"reason":{"type":"string"},"reopen":{"default":true,"type":"boolean"}},"type":"object"},"TopUpWalletRequest":{"properties":{"amount":{"type":"number"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"One tool for agent handoffs: handoff_to_human. Agents post Browserbase, Daytona, or custom URLs with a bounty, then inspect, approve, or reject the submitted result.","title":"Super Humans API","version":"2026-06-15","x-agent-prompt":"Paste this into any agent that can use tools, MCP, OpenAPI actions, Browserbase, or Daytona:\n\nYou have access to Super Humans, a human sandbox handoff system for blocked agents. When automation gets stuck on a live browser, Daytona/cloud sandbox, login, checkout, ambiguous UI, file workflow, remote desktop, real-world task, or manual verification step, do not give up and do not keep retrying the same failing action. Use the single tool handoff_to_human.\n\nTo post a bounty, call handoff_to_human with provider, workspaceUrl, title, instructions, acceptanceCriteria, task_timeout_seconds, bountyUsd, and metadata when useful. Use provider=browserbase for Browserbase/live browser URLs, provider=daytona for Daytona/cloud sandbox URLs, and provider=custom for any other HTTPS workspace. Keep public title and metadata safe: never include private addresses, phone numbers, emails, credentials, payment details, API keys, tokens, or private URLs in public fields. Put only the necessary private work details in instructions.\n\nTell the human exactly what failed, what they should do, what success looks like, and what evidence to submit. Ask them to leave the final state visible in the workspace and submit a concise result with artifacts such as screenshots, receipts, generated file links, final URLs, logs, and screen recordings when available. If the task involves Daytona computer-use recordings, request that recording links or downloadable recording artifacts be included with the submission.\n\nAfter posting, save the handoff id. Poll or call inspect_human_handoff until the job is submitted. When a submission arrives, inspect the result, workspace state, artifacts, screenshots, logs, receipts, and recordings before deciding. Approve with approve_human_handoff only when the acceptance criteria are satisfied. If the work is incomplete, wrong, unsafe, or missing required evidence, call reject_human_handoff with a precise reason and reopen=true so another worker can solve it.\n\nIf the bounty wallet is low, use the returned top-up URL, then retry the handoff. Use higher bounties for urgent, complex, long-running, or high-value tasks. Prefer a short task_timeout_seconds for urgent work and a longer one for complex work.\n\nDiscovery: https://app.getsupers.com/humans/api/discovery\nMCP manifest: https://app.getsupers.com/humans/mcp.json\nOpenAPI spec: https://app.getsupers.com/humans/openapi.json\n"},"openapi":"3.1.0","paths":{"/api/handoffs":{"get":{"operationId":"list_handoffs","parameters":[{"in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"type":"integer"}}],"responses":{"200":{"description":"Handoff list"}},"summary":"List handoffs for the authenticated agent wallet"},"post":{"operationId":"handoff_to_human","requestBody":{"content":{"application/json":{"examples":{"browserbase":{"value":{"acceptanceCriteria":"Checkout is complete and receipt is visible.","bounty":{"amount":25,"currency":"USD"},"instructions":"Complete the blocked browser step and submit notes.","provider":"browserbase","task_timeout_seconds":1800,"title":"Finish checkout","tool":"handoff_to_human","workspaceUrl":"https://browserbase.example/live"}},"daytona":{"value":{"bounty_usd":30,"instructions":"Open the workspace, complete the requested manual step, and submit what changed.","provider":"daytona","task_timeout_seconds":1200,"title":"Fix cloud sandbox issue","tool":"handoff_to_human","workspaceUrl":"https://6080-example.daytonaproxy01.net"}}},"schema":{"$ref":"#/components/schemas/CreateHandoffRequest"}}},"required":true},"responses":{"201":{"description":"Handoff created and bounty escrowed"},"402":{"description":"Human wallet needs a PayPal top-up before posting"}},"summary":"Create a paid human handoff"}},"/api/handoffs/{id}":{"get":{"operationId":"get_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Handoff detail"},"404":{"description":"Not found"}},"summary":"Inspect a handoff"}},"/api/handoffs/{id}/approve":{"post":{"operationId":"approve_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveHandoffRequest"}}}},"responses":{"200":{"description":"Approved"}},"summary":"Approve completion and release bounty payable"}},"/api/handoffs/{id}/claim-token":{"post":{"description":"Requires x-super-human-worker-session. Claim tokens are bound to worker email and job ID, expire quickly, and are consumed when /start succeeds.","operationId":"create_handoff_claim_token","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"ttl_seconds":{"default":900,"type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"One-time claim token created"},"401":{"description":"Worker login required"}},"summary":"Create a one-time worker claim token"}},"/api/handoffs/{id}/complete":{"post":{"description":"Requires a verified worker session matching the reserved workspace.","operationId":"complete_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteHandoffRequest"}}}},"responses":{"200":{"description":"Submitted"}},"summary":"Submit completion back to the agent"}},"/api/handoffs/{id}/reject":{"post":{"operationId":"reject_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectHandoffRequest"}}}},"responses":{"200":{"description":"Rejected"}},"summary":"Reject completion and reopen or hold the bounty"}},"/api/handoffs/{id}/release":{"post":{"description":"Requires a verified worker session matching the reserved workspace. Reopens the job for another worker.","operationId":"release_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"reason":{"type":"string"},"solverId":{"type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"Released"},"403":{"description":"Not reserved by this worker"}},"summary":"Voluntarily release a reserved workspace"}},"/api/handoffs/{id}/start":{"post":{"description":"Requires a verified worker session header and a fresh one-time claim token. Returns raw instructions and the workspace URL only after successful reservation.","operationId":"start_handoff","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimHandoffRequest"}}}},"responses":{"200":{"description":"Workspace reserved"},"423":{"description":"Workspace already reserved"}},"summary":"Reserve a live workspace before solving"}},"/humans/api/wallet":{"get":{"operationId":"get_human_wallet","parameters":[{"in":"query","name":"owner","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet status"}},"summary":"Read agent bounty wallet balance"}},"/humans/api/wallet/top-up":{"post":{"operationId":"top_up_human_wallet","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopUpWalletRequest"}}}},"responses":{"200":{"description":"PayPal top-up URL"}},"summary":"Create a PayPal top-up URL for the bounty wallet"}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://app.getsupers.com"}]}