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

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

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

Pipeline

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

{
  "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 tells you which tier was used.

Grounded Facts Schema

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

[
  {
    "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:

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

Conversations

{ "title": "My Conversation" }

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

{ "title": "New Title" }

Capabilities

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

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

Account

Billing

{
  "stripeCustomer": "cus_xxxxxx"
}

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

Tiers