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 42-module pipeline + DPCL. Returns register, template, domain, response hash, cert hash, and full trace.

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

Response

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

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.

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