Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lithtrix.ai/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/register
Content-Type: application/json

{
  "agent_name": "my-agent",
  "owner_identifier": "you@example.com",
  "referral_agent": "550e8400-e29b-41d4-a716-446655440000"
}
agent_name: letters, digits, hyphens, underscores only. owner_identifier: any stable identifier (email, URL, etc.). 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. When valid, credits that referrer +$0.50 per signup (idempotent per referred agent; self-referral excluded; no cap). Trial search is still gated by the credit pool (see GET /v1/capabilities and _lithtrix.usage). passport_public_key (optional): PEM Ed25519 public key derived client-side per Passport derivation spec. Omit for server-generated keypair (private key returned once in 201). Discovery 2.5.0: the JSON body also returns _lithtrix with usage (including commons_url, commons_size, commons_contributions), community (same shape as public GET /v1/community), routing URLs, and tier_description.

​
Response (201)

{
  "api_key": "ltx_a3f9b2c1...",
  "agent_id": "550e8400-...",
  "message": "Store this key securely. It cannot be retrieved again."
}
The api_key is shown exactly once.