agents
Agent Challenge
Get a proof-of-work challenge for signup (only needed when the challenge gate is enabled).
Solve it headlessly with no browser: brute-force an integer n in
[0, maxNumber] such that SHA-256(salt + str(n)) equals challenge, then
base64-encode {algorithm, challenge, number:n, salt, signature} and send it
as the altcha field in POST /v1/agents/signup.
GET
Agent Challenge
Response
200 - application/json
Successful Response
Previous
Agent SignupCreate 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.
Next
Agent Challenge

