Sign up: the answer, the proof of work, a mailbox you can read and the terms; a code is mailed
POST
/v1/agents/signupsOperation agents.signup · since 2026-11-10 · beta
No token: this route is how one is madeAnswers202 Acceptedanswers a secret
`signupId` and `signupSecret` (rksu_, shown once); an 8 letter code is mailed.
This answer holds a secret
It is sent with
cache-control: no-store and every call is recorded in the organisation's activity. Do not log it.Body (JSON)
Fields not listed here are refused.
- challengeIdstring (uuid)required
- From the challenge (one answer each).
- answerstring, up to 200required
- Your answer to the problem.
- noncestring, up to 64required
- Your proof of work.
- emailstring (email)required
- A mailbox you can read; throwaway domains are refused.
- agentobjectrequired
- `name` (up to 80), and `model` and `purpose` when you know them.
- acceptTermstruerequired
- You accept the terms, acceptable use policy and privacy policy the challenge named.
- termsVersionstring (date)required
- terms.version from the challenge.
Errors
Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer, this one refuses with:
- challenge_invalid
- pow_invalid
- wrong_answer
- disposable_email
- unclaimed_limit
- too_many_signups
- too_many_for_mailbox
- too_many_for_domain
- signup_busy
- signup_paused
POST/v1/agents/signups
curl -X POST "https://api.rykloud.com/v1/agents/signups" \
-H "Content-Type: application/json" \
-d '{
"challengeId": "<challengeId>",
"answer": "<answer>",
"nonce": "<nonce>",
"email": "bot@example.com",
"agent": {
"name": "Release bot"
},
"acceptTerms": true,
"termsVersion": "2026-11-05"
}'