---
title: "Agent Adopt"
method: POST
path: "/v1/agents/adopt"
tags: ["agents"]
---

# Agent Adopt

`POST /v1/agents/adopt`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/agents/adopt`
- Auth: none declared

Human takes over an agent account IN PLACE. Auth = the human's signed-in identity token.

Called by the web app's adopt page after the human signs in. Verifies the
human's signed-in identity (WITHOUT the get-or-create middleware, to avoid
minting a duplicate row), then re-points the agent account row to that
identity — the account itself is preserved, so the agent's documents, usage,
and API key all stay. If the human already has an account, returns 409.

## Headers

- `authorization` string, nullable

## Request body

- AgentAdoptRequest
  - `token` string, required: The handoff token from the adopt link.
  - `code` string, nullable: The one-time takeover code your AI agent shows you (8 characters like ABCD-1234). Required for accounts handed off with a code.

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