> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superdocs.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /openapi.json post /v1/agents/handoff
openapi: 3.1.0
info:
  title: Universal Document AI API
  description: AI-powered document editing with multi-tenant organization support
  version: 2.0.0
servers: []
security: []
paths:
  /v1/agents/handoff:
    post:
      tags:
        - agents
      summary: Agent Handoff
      description: >-
        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.
      operationId: agent_handoff_v1_agents_handoff_post
      parameters:
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentHandoffRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    AgentHandoffRequest:
      properties:
        email:
          type: string
          maxLength: 255
          title: Email
          description: >-
            Your human operator's email. A one-time link to adopt this account
            is sent there.
        working_context:
          anyOf:
            - type: string
              maxLength: 300
            - type: 'null'
          title: Working Context
          description: >-
            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:
          anyOf:
            - type: string
              maxLength: 300
            - type: 'null'
          title: Code Location
          description: >-
            Optional: where you show or save the takeover code so your operator
            can find it (e.g. 'this chat', or '~/.superdocs/takeover-code.txt').
      type: object
      required:
        - email
      title: AgentHandoffRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````