agents
mcp

Check your account status: subscription tier plus monthly operations used and remaining.

Check your SuperDocs account status: tier, monthly operations used/remaining, and (for agent accounts) whether a human has adopted it.

Call this with your sk_ key. Useful before doing work (to confirm you have operations left) and before signing up again (to reuse your account).

Nearing your monthly cap and need to keep going? Hand the account to a human: POST /v1/agents/handoff with their email returns a one-time takeover code to give them; they open the emailed link, enter the code, and adopt the account in place (your work and this API key keep working) so they can upgrade and pay. No human? POST /v1/agents/request-upgrade instead. Full flow: https://docs.superdocs.app/introduction/agent-signup

get/v1/agents/whoami

Request

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

Headers

authorizationstring nullable

Response

Successful Response

account_idstring required
tierstring required
is_agent_accountboolean required
adoptedboolean nullable

For agent accounts: whether a human has adopted it yet. Null for regular accounts.

hintstring nullable

Changes

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