Skip to main content
POST
Agent Signup

Body

application/json

Body for POST /v1/agents/signup. Every field except terms_accepted is optional.

terms_accepted
boolean
default:false

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

agent_name
string | null

Optional label for this agent account.

Maximum string length: 64
operated_by_email
string | null

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

Maximum string length: 255
model_metadata
Model Metadata · object | null

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

altcha
string | null

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

Response

Successful Response

account_id
string
required
slug
string
required
email
string
required
api_key
string
required

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

quota
AgentQuota · object
required
endpoints
Endpoints · object
required
mcp_setup
Mcp Setup · object
required

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

handoff
Handoff · object
required
important
string
required