AXIOM API

Base URL: https://axiom42.com · Version: v1

Authentication

Authenticated endpoints accept either an API key or a JWT token:

Authorization: Bearer ax_live_xxxxxxxx    # API key
Authorization: Bearer eyJhbGci...         # JWT token

Auth

POST /v1/auth/signup Public

Create a new account. Returns an API key (shown once) and JWT.

{
  "email": "user@example.com",
  "password": "min8chars",
  "name": "Optional Name"
}

POST /v1/auth/login Public

{
  "email": "user@example.com",
  "password": "yourpassword"
}

Pipeline

POST /v1/speak Auth Optional

Process input through the 148-domain pipeline + DPCL. Axiom automatically selects the optimal response tier. Returns register, template, domain, response hash, cert hash, response mode, and full trace.

{
  "input": "What are the deterministic inference rules?"
}

Response

{
  "response": "...",
  "responseMode": "DETERMINISTIC",
  "register": "EXPLANATORY",
  "template": "EXPLANATORY.DETERMINISTIC_REASONING.QUERY",
  "domain": "DETERMINISTIC_REASONING",
  "intentType": "QUERY",
  "pipelineStatus": "COMPLETE",
  "responseHash": "sha256:...",
  "certHash": "sha256:...",
  "groundedFacts": [],
  "pipeline_duration": 22.4,
  "dpcl_duration": 1.1,
  "total_duration": 23.5,
  "trace": [...]
}

Response Modes

Axiom dynamically selects the optimal response tier for every query. The responseMode field in every response tells you which tier was used.

Mode	Engine	Description
`DETERMINISTIC`	Pure Lume	Direct knowledge-pack hit. No LLM. Zero hallucination. Sub-2ms. The gold standard.
`GROUNDED`	Fact-Constrained LLM	Retrieves top relevant facts from the 181K+ knowledge base, then composes a fluent response using only those facts. The `groundedFacts` array contains the source citations.
`CONVERSATIONAL`	Lume-V Governed	Full LLM (Claude 3.5) governed by the Lume-V trust layer. Used only when no relevant knowledge exists. Always clearly labeled.

Grounded Facts Schema

When responseMode is "GROUNDED", the groundedFacts array contains the source facts that constrained the response:

[
  {
    "key": "cinco_de_mayo",
    "domain": "HISTORY",
    "score": 0.85,
    "snippet": "Cinco de Mayo commemorates the Mexican Army's victory..."
  }
]

Auto-Routing

You don't need to specify a mode — Axiom's auto-router selects the best tier:

Tier 1: If the knowledge engine finds an exact match → DETERMINISTIC
Tier 2: If relevant facts exist but no exact match → GROUNDED
Tier 3: If no relevant knowledge exists → CONVERSATIONAL

Conversations

POST /v1/conversations Auth Required

Create a new conversation thread.

{ "title": "My Conversation" }

GET /v1/conversations Auth Required

List all conversations, sorted by most recent. Optional ?limit=50.

GET /v1/conversations/:id Auth Required

Get a conversation with all its turns.

POST /v1/conversations/:id/speak Auth Required

Send a message within a specific conversation thread. Auto-titles from first message.

{ "input": "Explain the safety envelope." }

PATCH /v1/conversations/:id Auth Required

Rename a conversation.

{ "title": "New Title" }

DELETE /v1/conversations/:id Auth Required

Delete a conversation and all its turns.

Capabilities

POST /v1/generate/image Auth Required

Generate an image via DALL-E 3. Subject to tier quota.

{ "prompt": "A cybernetic owl", "size": "1024x1024" }

POST /v1/code/voice-to-lume Public

Convert natural language to Lume code.

{ "text": "create a variable called name with value hello" }

Account

GET /v1/me Auth Required

Get current tenant info, tier, limits, and API key prefix.

GET /v1/usage Auth Required

Monthly usage statistics and tier limits.

POST /v1/keys/rotate Auth Required

Rotate your API key. Old key stops working immediately.

Billing

POST /v1/billing/portal Auth Required

Open the Stripe Customer Portal to manage your subscription — cancel, downgrade, or update payment method. Cancel anytime.

{
  "stripeCustomer": "cus_xxxxxx"
}

Response

{
  "url": "https://billing.stripe.com/session/..."
}

Tiers

Tier	Price	Queries/mo	Max Input	Audit	Images
Free	$0	100	500 chars	—	5/mo
Developer	$29	5,000	2,000 chars	✓	50/mo
Business	$99	50,000	5,000 chars	✓	200/mo
Enterprise	$499	Unlimited	10,000 chars	✓	Unlimited