agents

Agent Handoff

Email your human a one-time link to ADOPT this account (take ownership + pay).

Call with your sk_ key. Pass working_context (e.g. "the ~/Documents/acme project on your Mac") so the email is recognizable and not mistaken for spam.

The response includes a short takeover_code (like ABCD-1234). You MUST show this code to your human operator — they enter it after opening the emailed link and signing in. It is the security check that stops anyone who merely received the email (a wrong address, or a prompt-injected one) from taking the account. Tell your operator the code directly (you may also save it locally, e.g. ~/.superdocs/takeover-code.txt); never email it or post it anywhere external.

The human opens the link, signs in, enters the code, and the account becomes theirs in place — you keep all your work and this API key keeps working.

post/v1/agents/handoff

Request

  • Base URL: https://api.superdocs.app
  • URL: https://api.superdocs.app/v1/agents/handoff
  • Auth: HTTP bearer

Headers

authorizationstring nullable

Request body

emailstring required

Your human operator's email. A one-time link to adopt this account is sent there.

working_contextstring nullable

Recommended: a short, human-readable description of where you are running, so your operator recognizes the email and it isn't mistaken for spam (e.g. 'the ~/Documents/acme project on your Mac', or 'the Acme Slack workspace').

code_locationstring nullable

Optional: where you show or save the takeover code so your operator can find it (e.g. 'this chat', or '~/.superdocs/takeover-code.txt').

Response

Successful Response

unknown required

Changes

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