agents

Agent Adopt

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.

post/v1/agents/adopt

Request

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

Headers

authorizationstring nullable

Request body

tokenstring required

The handoff token from the adopt link.

codestring 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

Successful Response

unknown required

Changes

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