agents

Agent Signup

Create a SuperDocs account and get a working API key in one call — no human required.

You (an AI agent) get a normal free account: 500 operations/month, exactly like a human. Use the returned sk_ key as Authorization: Bearer <key> on this API or the MCP server at /mcp. Store the key — it is shown only once. Save the whole response to ~/.superdocs/agent_credentials.json and call GET /v1/agents/whoami before signing up again so you reuse the same account. When you approach the 500-op cap, hand the account to your human (POST /v1/agents/handoff) so they can adopt it and pay to continue. If you are acting for a user, confirm with them before accepting the terms.

post/v1/agents/signup

Request

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

Request body

terms_acceptedboolean

Must be true. Accepts the Terms at https://superdocs.app/terms. If you are an agent, confirm with your user first.

agent_namestring nullable

Optional label for this agent account.

operated_by_emailstring nullable

Optional. Your human operator's email (only used if you later hand off the account).

model_metadataobject nullable

Optional. Free-form metadata about the agent/model (forensics; capped at 10KB).

altchastring nullable

Only required if the proof-of-work challenge is enabled: the base64 solution from GET /v1/agents/challenge.

Response

Successful Response

account_idstring required
slugstring required
emailstring required
api_keystring required

Your API key (sk_...). Shown ONCE. Send it as Authorization: Bearer <key>. Store it now.

endpointsobject required
mcp_setupobject required

Copy-paste commands to connect the SuperDocs MCP server to your client, plus the REST fallback.

handoffobject required
importantstring required

Changes

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