Skip to the page

Sign up: the answer, the proof of work, a mailbox you can read and the terms; a code is mailed

POST/v1/agents/signups

Operation 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"
}'