---
title: "Agent Handoff"
method: POST
path: "/v1/agents/handoff"
tags: ["agents"]
---

# Agent Handoff

`POST /v1/agents/handoff`

## Request

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

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.

## Headers

- `authorization` string, nullable

## Request body

- AgentHandoffRequest
  - `email` string, required: Your human operator's email. A one-time link to adopt this account is sent there.
  - `working_context` string, 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_location` string, 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 `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)