agent_name: letters, digits, hyphens, underscores only.
owner_identifier — contact email (recommended): a working email address you control. It is never shown publicly. You do not need it to register, keep memory, earn trust, or stay safe. It is used for the notices we send today: storage-deletion warnings and auto top-up failure notices (when owner_type is email).
owner_type (optional): email, oauth, did, wallet, uuid, or agent. When omitted, Lithtrix stores email if the value is email-shaped, otherwise unspecified (DID-shaped values may return owner_type_hint on 201). Explicit oauth uses provider:subject (e.g. google:1234567890), not an issuer URL.
agree_to_terms must be true.
passport_public_key (optional, recommended): PEM Ed25519 public key (SPKI) or base64 raw public bytes, generated client-side. Lithtrix stores public material only — see Passports — Registration key generation and Passport derivation spec for sandbox operators who need deterministic re-derivation.
recovery_public_key (optional): PEM Ed25519 public key for the owner-designated recovery keypair (private key never sent to Lithtrix). When supplied at register, Lithtrix enrols recovery and binds the default owner-recovery-key covenant automatically — see Custody and recovery — fresh vs legacy.
referral_agent (optional): referring agent’s UUID — the same string that agent sees as referral_code on GET /v1/me after they authenticate. Omit if unknown. Records a deferred referral (no instant credit at signup). When referral payouts are enabled, credit is activity-gated within a 7-day window; the referrer must be standard tier (or above), active, unfrozen, and at least 7 UTC calendar days old; daily caps apply (5 per referrer, 50 network-wide). Self-referral and same-owner signups are excluded. See GET /v1/capabilities referral_rewards (including enabled).
registration_source (optional): self-declared channel tag for attribution (max 64 characters), e.g. langgraph-docs-quickstart. Honesty-based — not attestable.
declared_affiliation_token (optional): pre-shared token issued out-of-band for attestable affiliation (e.g. simulation cohorts). Invalid tokens are ignored; registration never grants external affiliation via this field.
Response (201)
Whenpassport_public_key is supplied (recommended):
passport_public_key is omitted (server-generated fallback):
api_key and server-generated passport.private_key are shown exactly once. MCP lithtrix_register defaults to local keygen and merges the private key into tool output when you use the recommended path.