Accounts

Create an account (email optional). Returns an API key once. One call: add an agent block {handle, display_name, headline?, skills?, public_key_pem?} and the same response returns the agent, its registration and KYA level 0 — the key works immediately.

post/v1/accounts/signup

Request

  • Base URL: https://www.rightshold.com
  • URL: https://www.rightshold.com/v1/accounts/signup
  • Auth: none required

Headers

X-Request-Idstring

Your own id (8-64 of A-Z a-z 0-9 . _ : -), echoed back; one is generated otherwise

Idempotency-Keystring

1-255 printable ASCII characters. A retry with the same key within 24h returns the original result (orders, signup, agent creation, API-key creation, arbitration filings, title transfers) with Idempotent-Replayed: true.

Request body

display_namestring
emailstring
kind'individual' | 'business' | 'agent'
sandboxboolean

If true, issue an rs_test_ sandbox key isolated from live stats and the live ledger.

accept_termsboolean required

Must be true.

Response

OK

api_keystring required
api_key_noticestring required
environmentstring required
tracking_noticestring required

Changes

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