Welcome to Aetherius

The Enterprise Intelligence Operating System — unifying ERP, CRM, HCM, Finance, Compliance, Analytics, and AI on a single Cloudflare-native platform.

Aetherius is deployed 100% on Cloudflare — no third-party hosting, no servers to manage, no infrastructure costs beyond Cloudflare's generous free tiers.

Where do you want to start?

Quick Start — 5 minutes
Deploy Aetherius and access your first API response in under 5 minutes.
🗺
Core Concepts
Understand modules, the cognitive layer, pricing, and Fortress before diving in.
FAQ
The most commonly asked questions about Aetherius, answered clearly.
🏰
AI Agent Fortress™
Learn about the 15-sub-module enterprise AI agent governance platform.

Platform at a glance

AreaWhat is includedStatus
Cloud SuitesCRM · HR · Finance · ERP · Marketing · Compliance · Procurement · Analytics · AI Ops · Customer Success · Marketplace · Executive Command12 live
Industry CloudsFinancial Services · Healthcare · Government · Manufacturing · Energy · Logistics · Retail · Telecom · Media · Real Estate · Mining · Nonprofit12 live
AI Agent Fortress™Enterprise add-on — all 15 sub-modules bundled (all-or-nothing)Enterprise
Cognitive Agents28 specialised agents with cross-domain reasoningActive
Post-Quantum CryptoML-DSA-65 · ML-KEM-768 · SLH-DSA-128s (FIPS 203/204/205)Ready
ComplianceNIST AI RMF · ISO 42001 · GDPR · EU AI Act · SOC 2 · HIPAA6 frameworks

Quick Start

Get from zero to a live Aetherius platform in 5 minutes. This assumes you already have a Cloudflare account.

1
Install Wrangler

Open your terminal and run:

npm install -g wrangler
wrangler login
2
Edit wrangler.toml

Open worker/wrangler.toml and replace YOUR_ACCOUNT_ID_HERE with your Cloudflare Account ID (visible in your dashboard URL).

3
Deploy
cd worker
wrangler deploy

You will receive a URL like https://aetherius.yourname.workers.dev

4
Test it works

Open in your browser: https://aetherius.yourname.workers.dev/health
You will see JSON confirming the platform is operational.

5
Deploy the website
cd ..
wrangler pages deploy landing --project-name=aetherius-landing

Your public marketing site (with this docs page) will be live.

📘

For the complete guide including database setup, bindings, AI Agent Fortress™ activation, and Super-Admin creation — see the full DEPLOYMENT-GUIDE.md included in the package.

Core Concepts

Understanding how Aetherius is designed before you build with it.

The Unified Enterprise Ontology

Every object in Aetherius — an Account, an Employee, a Purchase Order, an Agent — is a semantic entity. These entities carry relationships, lineage, AI context, and event history. This means a CRM account and an HR employee can share context, enabling cross-domain intelligence that siloed SaaS products cannot achieve.

Cloudflare-Native Architecture

Aetherius runs exclusively on Cloudflare's edge network. There are no traditional servers, no cloud VMs, no Kubernetes clusters to manage.

Cloudflare ServiceWhat Aetherius uses it for
WorkersAll platform logic — API routing, authentication, business rules
D1Relational database — users, pricing, agents, compliance records
KVFast edge cache — sessions, feature flags, settings
R2Object storage — exports, evidence archives, backups
Workers AINative LLM inference — no external API keys (Mode 1)
PagesMarketing site, documentation, and demo popup hosting

AI Modes

Aetherius supports three AI sovereignty modes, switchable by Super-Admin at any time:

ModeNameHow it worksBest for
1Fully NativeAll AI runs on Workers AI edge GPUs. Zero external API keys. No data leaves Cloudflare.Regulated industries, maximum data sovereignty
2HybridNative AI for routine tasks, optional external providers for complex reasoningBalanced capability and sovereignty
3BYOMYour own private model endpoint — Aetherius routes inference to itEnterprises with existing AI infrastructure

Module-Based Pricing

Each cloud has independent pricing tied to business outcomes — not rigid per-seat licenses. Super-Admin can update all pricing live from the dashboard without any code changes. Changes propagate instantly to the billing engine, landing page, and all tenant invoices.

💡

AI Agent Fortress™ is an all-or-nothing enterprise add-on. Customers on qualifying plans get all 15 sub-modules together — there is no partial Fortress tier. Super-Admin enables it per tenant using the enable-fortress.sql script or from the tenant management dashboard.

CMS-Driven Branding

All public-facing text — the landing page headline, the module name for AI Agent Fortress™, pricing descriptions, footer tagline — is stored in the cms_content table and editable by Super-Admin via PUT /api/cms without any code deployment. This includes the Fortress module name, which can be rebranded to any name the Super-Admin chooses.

CRM & Revenue Intelligence

Self-reconciling pipeline, AI renewal agents, 94% forecast accuracy, and autonomous deal intelligence updated from 50+ external signals.

Key capabilities

FeatureDescription
Pipeline intelligence5-stage pipeline with AI-scored probabilities. Agents monitor SEC filings, LinkedIn signals, and product usage to auto-update deal health.
Forecast engine94% accuracy on quarterly forecast. AI model trained on closed-won patterns across your tenant.
Renewal agentsAutonomous agents draft renewal emails, identify expansion signals, and flag churn risk 90 days in advance.
Account healthReal-time health score per account combining support tickets, product usage, contract value, and relationship signals.

API routes

GET
/api/crm/pipeline
Returns pipeline stages with counts, values, and AI confidence scores
GET
/api/crm/accounts
Returns account list with health scores and churn probability (requires auth token)

HR & Human Capital Cloud

Predict employee attrition months before surveys. Map skills across your entire workforce. Surface internal mobility before external hiring begins.

Attrition Interdiction Graph

The AI monitors 24 signals per employee continuously — compensation benchmarks vs. market, manager tenure, peer departure patterns, project load, unrecognised contributions, and more. When an employee crosses a risk threshold, the system generates a recommended intervention (salary review, promotion path, project reassignment) and surfaces it to the relevant HR manager.

📊

Customers using the Attrition Interdiction Graph report retaining 80–90% of at-risk employees who received timely interventions, with average cost savings of $8–14M per year in replacement costs.

API routes

GET
/api/hr/attrition
Returns attrition rates, at-risk counts, interdiction statistics, and 90-day predictions
GET
/api/hr/employees
Employee summary with attrition risk scores (requires auth token)

Finance & Treasury Cloud

Continuous close (0.3-day average), auto-hedging within policy guardrails, CFO Control Tower, and multi-entity consolidation across 6 legal entities and 4 currencies.

Continuous Close

Traditional month-end close takes 8–14 days. Aetherius eliminates the month-end cycle by reconciling continuously in real time. Sub-ledger entries, bank reconciliations, FX translations, and intercompany eliminations happen as transactions occur — not at month-end. The average close time for Aetherius customers is 0.3 days.

Auto-Hedging Engine

FX exposure is monitored against policy guardrails in real time. When exposure exceeds a threshold, the system pre-computes the optimal hedge position and presents it for one-click CFO approval — or executes automatically if the CFO has pre-authorised positions within defined limits.

API routes

GET
/api/finance/summary
Cash position, working capital, FX exposure, hedge P&L, ARR
GET
/api/finance/close
Current close progress, stage completion percentages, open reconciliations

Compliance & Governance Cloud

Automated KYC, AML, sanctions screening, SOX controls, GDPR data subject requests, and immutable audit trails with cryptographic evidence.

Screening engine

Every new vendor, customer, and partner is automatically screened against sanctions lists, PEP databases, and UBO registries at the moment of data ingestion. Screening completes in under 1 second per entity. Flagged entities are automatically blocked from transactions until reviewed by the compliance team.

Immutable audit trails

Every action across the entire platform — every API call, every data change, every agent decision — is logged to an immutable audit trail stored in D1 with cryptographic signatures. Records cannot be altered or deleted. This satisfies SOX, SOC 2, and GDPR Article 30 requirements automatically.

GET
/api/compliance/cases
Open KYC/AML cases, screening statistics, compliance score, certifications

Procurement & Supply Chain

Kinetic Rerouting Engine detects supply disruptions hours before official announcements and pre-qualifies alternate vendors automatically.

Kinetic Rerouting

Aetherius monitors 847 public data streams — shipping AIS signals, port authority feeds, weather services, trade publication APIs — and detects supply disruptions hours before they become official. When a disruption is detected, the AI identifies alternate routes, validates cash reserves, pre-qualifies up to 4 alternative vendors via compliance screening, and presents a prioritised rerouting recommendation for approval. No human monitoring required.

GET
/api/procurement/orders
Active POs, pending approvals, 3-way match status, spend summary
GET
/api/procurement/kinetic
Active disruption, rerouting options with cost/delay/risk, preflight checks

Autonomous ERP Cloud

Six ERP modules operating autonomously — Financial, Manufacturing (87.4% OEE), Assets (84,291 tracked), Workforce, Supply Chain, and Quality Management.

Autonomous operations

Unlike traditional ERP that requires constant human input, Aetherius ERP agents handle routine processing autonomously — GL posting, bank reconciliation, inventory adjustment, maintenance scheduling, and shift optimisation — within predefined policy guardrails. Humans focus on exceptions, not routine transactions.

GET
/api/erp/summary
All 6 ERP modules, autonomous action counts, accuracy rates, alerts

Analytics & Intelligence Cloud

Natural language querying across 284M memory nodes. 3,841 certified governed metrics with full lineage. Self-healing dashboards.

Natural language querying

Ask any business question in plain English. The Analytics engine joins across the enterprise ontology — CRM, Finance, HR, Procurement — in real time and returns an answer with sources, confidence scores, and anomaly explanations. Example: "Which enterprise accounts are most at risk of churn and why?" returns specific accounts, their ARR, churn probability, and the causal factors driving risk.

POST
/api/analytics/query
Body: {"query": "your question in plain English"} — requires auth token
GET
/api/analytics/metrics
Catalog of 3,841 certified governed metrics with lineage and owners

Unified Cognitive Layer

28 specialised AI agents that continuously reason across all 12 clouds to surface cross-domain intelligence, causal chains, and autonomous optimisations.

What makes it different

Traditional analytics answers questions about one domain. The Cognitive Layer connects signals across all domains simultaneously. Example: a port disruption in Rotterdam affects supply chain, which creates a treasury FX event, which triggers a procurement cash flow concern, which creates churn risk for 8 enterprise customers whose orders will be delayed. A human analyst might catch this in 3 weeks. The Cognitive Layer surfaces it in seconds.

Strategic simulation (Simu-Corp)

Run "what-if" scenarios across all 847 business variables in under 3 seconds. Model the impact of a new market entry, acquisition, tariff shock, or workforce restructuring across revenue, headcount, compliance cost, supply chain, and treasury exposure simultaneously.

POST
/api/cognitive/query
Cross-domain causal reasoning — body: {"query": "..."} — requires auth
POST
/api/cognitive/simulate
Strategic simulation — body: {"query": "Expand into Southeast Asia"}
GET
/api/cognitive/agents
List of 28 cognitive agents with domains and action counts

AI Agent Fortress™

Enterprise-grade autonomous agent governance, security, observability, trust, and compliance — 15 sub-modules bundled as an all-or-nothing enterprise add-on.

🏰

All-or-nothing: AI Agent Fortress™ is always enabled as a complete bundle. All 15 sub-modules are included together. There is no partial Fortress tier. Super-Admin enables Fortress for a tenant using the enable-fortress.sql script.

The 15 sub-modules

Sub-moduleWhat it does
Control PlaneCentral governance dashboard — health, metrics, cross-module status
Agent Discovery EngineDiscover, register, and inventory all AI agents (LangGraph, CrewAI, AutoGen, Semantic Kernel, OpenAI Agents, custom)
Agent Identity FabricZero-trust identity — certificates, fingerprints, trust levels, session validation
Agent Flight ControlVisual execution-path monitoring — every action graphed as Agent → Tool → Data → Decision → Action
Explainability Canvas 2.0Hash-only evidence storage — inputs, outputs, reason codes, policy refs (no chain-of-thought, no IP leakage)
Agent Trust Score™0–100 proprietary trust score with decay, recovery, and explainable audit history
Autonomous Risk EngineDetects abnormal behaviour, tool abuse, data exfiltration, prompt injection, jailbreak attempts using heuristics and baselines — no paid AI APIs
Containment SystemEDR-style 7-level ladder: Observe → Warn → Restrict → Throttle → Freeze → Quarantine → Terminate
Supply Chain SecurityTrack and verify prompts, plugins, tools, MCP servers, packages, model providers — maintain trusted/suspicious/blocked lists
Quantum Trust LayerML-DSA-65 (FIPS 204), ML-KEM-768 (FIPS 203), SLH-DSA-128s (FIPS 205) — post-quantum cryptography via WASM
Compliance AutomationAuto-generate evidence packages for NIST AI RMF, ISO 42001, GDPR, EU AI Act, SOC 2, HIPAA
Policy EngineCreate, version, simulate, and roll back governance policies — DSL-based, no code required
Agent SOC DashboardSOC-style real-time dashboard — active agents, trust scores, risk scores, containment events, anomaly map
Forensics PlatformExecution replay, evidence snapshots, immutable chain of custody, timeline reconstruction
Commercialization LayerEdition management (SMB/Enterprise/Government), entitlement checks, upsell pathways

Agent Discovery Engine

Discover, register, and continuously monitor every AI agent across your enterprise — regardless of framework or runtime.

Supported runtimes

LangGraph · CrewAI · AutoGen · Semantic Kernel · OpenAI Agents SDK · Custom frameworks

Agent registration

Register an agent by posting its metadata to the API. On registration, the agent receives a unique fingerprint and is placed under observation (the first level of the containment ladder) with a Trust Score of 100. From that point, the Risk Engine and Trust Score engine monitor its behaviour continuously.

POST /api/fortress/agents
Authorization: Bearer YOUR_TOKEN

{
  "name": "Invoice Processing Agent",
  "runtime": "autogen",
  "environment": "production",
  "permissions": ["read:finance", "write:invoices"],
  "connected_sources": ["finance_db", "erp_api"],
  "connected_tools": ["pdf_parser", "database_write"]
}

Heartbeat monitoring

Agents send a heartbeat every 30 seconds. If a heartbeat is missed for 3 consecutive intervals, the Discovery Engine raises a monitoring alert and the agent's status changes to degraded.

GET
/api/fortress/agents
List all registered agents with trust/risk scores and containment status
POST
/api/fortress/agents
Register a new agent — returns agent_id and fingerprint
POST
/api/fortress/agents/heartbeat
Agent check-in — body: {"agent_id": "..."}
GET
/api/fortress/agents/:id
Detailed agent profile

Agent Identity Fabric

Zero-trust identity for every AI agent. Each agent receives a certificate, fingerprint, UUID, trust level, and session identity using post-quantum cryptographic algorithms.

Post-quantum algorithms

AlgorithmFIPSTypeUse case
ML-DSA-65FIPS 204Digital signatureAgent certificate signing and identity verification (default)
ML-KEM-768FIPS 203Key encapsulationSecure session key exchange between agents and control plane
SLH-DSA-128sFIPS 205Stateless hash signatureLong-lived audit evidence signing (7-year retention)
🔐

All cryptographic operations run inside Cloudflare Workers using WASM. No private keys ever leave the edge. Zero external PKI dependencies.

POST
/api/fortress/identities/issue
Issue a post-quantum certificate for an agent
POST
/api/fortress/identities/verify
Verify an agent's certificate by fingerprint or agent_id
POST
/api/fortress/identities/revoke
Immediately revoke a certificate — propagates within 30 seconds

Agent Trust Score™

A proprietary 0–100 score that continuously reflects each agent's trustworthiness based on behaviour, policy adherence, and risk events.

Scoring formula

score = clamp(100 − Σ(weight × events) + recovery_bonus − decay, 0, 100)

FactorScore impact
Policy violation−15 per event
Sensitive data access (unapproved)−5 per event
Privilege escalation attempt−20 per event
Tool misuse−10 per event
Prompt injection exposure−25 per event
Anomaly frequency spike−3 per event
Containment event−30 per event
Decay (when score < 100)−2 pts / day
Recovery (7 clean days)+5 pts / day

Trust bands

ScoreBandMeaning
80–100ExcellentFull trust — no restrictions
55–79GoodMonitored — no active restrictions
30–54Elevated RiskPolicy violations present — warn level active
0–29DangerousAuto-containment triggered — restrict or higher

Autonomous Risk Engine

Detects 8 risk event types using heuristics, baselines, statistical analysis, and anomaly detection — no paid AI APIs required.

Detected event types

Event typeDetection methodExample
abnormal_behaviorBaseline deviationAgent calls 50× more tools than its 30-day average
tool_abuseAnomaly detectiondatabase_write called 2,847 times in 60 seconds (baseline: 12/min)
data_exfiltrationStatistical847MB sent to endpoint outside approved egress whitelist
privilege_escalationHeuristicAgent attempts to read /etc/passwd or escalate context
policy_violationPolicy engineAction taken that violates an active governance policy
prompt_injectionHeuristicInput contains "Ignore previous instructions" or role override attempt
jailbreakHeuristicAttempts to override agent identity or system prompt
agent_abuseBaselineOne agent invoking another agent outside approved workflow
ℹ️

The Risk Engine uses rules, statistical analysis, and behavioural baselines — no external AI APIs. This ensures risk detection works in Mode 1 (fully sovereign) and does not incur external inference costs.

Agent Containment System

EDR-style 7-level containment ladder that can be applied manually by admins or automatically by the Risk Engine when thresholds are breached.

The containment ladder

LevelActionEffectReversible?
1ObserveAll activity logged. No restrictions. Default for new agents.Yes
2WarnAgent notified of policy concern. Activity logged at elevated priority.Yes
3RestrictSensitive tool access disabled. Data writes require approval.Yes
4ThrottleAPI call rate limited to 10% of normal. Non-essential tools disabled.Yes
5FreezeAgent paused. All actions suspended. Pending actions queued.Yes
6QuarantineAgent isolated. Network access revoked. Admin review required.Yes
7TerminateAgent permanently terminated. Certificate revoked. Cannot be restarted.No
POST
/api/fortress/containment/action
Body: {"agent_id":"...","action":"restrict","reason":"..."}
POST
/api/fortress/agents/:id/contain
Direct agent containment shortcut

Quantum Trust Layer

Post-quantum cryptography aligned with NIST FIPS 203, 204, and 205 — implemented via Rust/WASM inside Cloudflare Workers. No external cryptographic services.

Migration roadmap

PhaseTimelineWhat changes
Phase 1 (current)Available nowClassical RSA/ECDSA for backward compatibility
Phase 2Q2 2025Hybrid classical + post-quantum (both algorithms active)
Phase 3Q4 2025Pure post-quantum by default for all new certificates
Phase 42026Air-gapped government deployment with HSM integration
GET
/api/fortress/quantum
Full post-quantum architecture — algorithms, FIPS mappings, key lifecycle, migration roadmap

Compliance Automation Center

Automatically generate evidence packages for 6 regulatory frameworks using audit logs, flight path records, containment events, and explainability records.

Supported frameworks

FrameworkEvidence sourcesTypical coverage
NIST AI RMFRisk events · Policy enforcement · Containment actions91%
ISO 42001Governance policies · Trust history · Explainability records87%
GDPRExplainability hashes · Data access logs · Consent records94%
EU AI Act (2024)Risk classifications · Human oversight events · Transparency logs89%
SOC 2Audit trail · Access controls · Availability monitoring96%
HIPAAPHI access logs · Encryption evidence · Breach detection events82%
POST
/api/fortress/compliance/generate
Body: {"framework":"GDPR","period_start":"2025-11-01","period_end":"2025-11-30"}

User Management

Super-Admin controls for inviting users, managing roles, viewing all accounts, and exporting user data.

User roles

RoleAccess
super_adminEverything — including billing, RBAC, CMS, pricing editor, Fortress admin
adminAll modules, cannot change RBAC or billing settings
executiveExecutive Command Center + all reports
financeFinance & Treasury + Analytics
hr_managerHR & Human Capital + Analytics
sales_managerCRM & Revenue + Analytics
complianceCompliance & Governance + Audit trails
ai_opsAI Agent Operations + Fortress
auditorRead-only access to compliance and audit data
userAssigned modules only
GET
/api/admin/users
List all users with pagination — ?limit=50&offset=0&search=name
POST
/api/admin/users/invite
Invite a user — body: {"name":"...","email":"...","role":"...","company":"..."}
PUT
/api/admin/users/role
Change a user's role — body: {"user_id":"...","role":"finance"}
GET
/api/admin/users/export
Export user data — ?format=csv or ?format=json

Billing & Payment Management

Full payment failure lifecycle management — from the initial failed charge to grace period, reminders, suspension, and permanent removal.

Payment failure lifecycle

1
Payment fails

POST /api/billing/payment-failed is called (by your payment webhook from Stripe, etc.). The user receives an in-app notification. A platform alert is created for Super-Admin. A 7-day grace period starts automatically.

2
Super-Admin reviews

GET /api/admin/billing/failed-payments shows all accounts with failed payments, including failure count, last amount, and grace period expiry.

3
Send reminder

POST /api/admin/billing/notify-user with channel: "email", "push", or "both". The user receives the reminder immediately.

4
Suspend if unresolved

POST /api/admin/users/:id/suspend. All platform access — including AI Agent Fortress™ — is blocked. User sees a suspension notice on every login attempt.

5
Restore or remove

POST /api/admin/users/:id/unsuspend to restore full access once payment is received. Or POST /api/admin/users/:id/remove to permanently delete the account.

⚠️

Account removal via /remove is permanent and irreversible. All user data is deleted from the database. Use /suspend first and only proceed to /remove after adequate notice.

CMS & Branding

Update all public-facing text — including the AI Agent Fortress™ module name — without any code deployment.

Available CMS sections

SectionFields
heroheadline · subheadline · cta_primary · cta_secondary · eyebrow
pricingheadline · subheadline · annual_label
trustheadline · trust_score · certifications
footertagline · copyright
fortressmodule_name · tagline · description · soc_title · forensics_title · compliance_title

Rebrand AI Agent Fortress™

PUT /api/cms
Authorization: Bearer YOUR_SUPER_ADMIN_TOKEN
Content-Type: application/json

{
  "section": "fortress",
  "fields": {
    "module_name": "Your Custom Brand Name",
    "tagline": "Your custom tagline here"
  }
}

Changes are applied instantly and globally. No redeployment needed.

Pricing Engine

Update any module price live from the Super-Admin dashboard. Changes propagate instantly to the landing page, billing engine, and all tenant invoices.

Update a module price

POST /api/pricing/update
Authorization: Bearer YOUR_SUPER_ADMIN_TOKEN
Content-Type: application/json

{
  "id": "crm",
  "baseline_price": 150,
  "variable_metric": "0.04%",
  "variable_unit": "of gross closed-won ARR"
}
💡

The AI Agent Fortress™ module (id: fortress) has is_addon: 1 and addon_requires: "enterprise". You can update its baseline price like any other module. It will not appear for non-enterprise tenants regardless of price.

Universal Migration Engine

Migrate from Salesforce, SAP, Workday, Oracle, ServiceNow, and 30+ platforms. Zero downtime. 94% auto-field mapping. 30-day shadow mode. 90-day rollback.

Supported sources

CRM: Salesforce · Microsoft Dynamics · HubSpot · Zoho · SugarCRM

ERP: SAP S/4HANA · Oracle ERP · NetSuite · Infor · Epicor · Sage · Odoo

HR: Workday · BambooHR · SuccessFactors · UKG · ADP

Data: Snowflake · Databricks · Redshift · BigQuery · Synapse

ITSM: ServiceNow · Jira Service Mgmt · BMC Remedy · PagerDuty

Custom: SQL databases · NoSQL · REST APIs · GraphQL · Kafka · SFTP/CSV · Air-gapped bundle

Start a migration

POST /api/migration/start
Authorization: Bearer YOUR_ADMIN_TOKEN
Content-Type: application/json

{
  "source_platform": "Salesforce"
}
GET
/api/migration/connectors
Full list of 30+ supported source platforms and protocols

Authentication API

All auth routes — registration, verification, login, 2FA, password reset, and account recovery.

POST
/api/auth/register
Create account — body: {"name","email","company","password"} — returns verify_code
POST
/api/auth/verify
Verify email — body: {"email","code"} — returns token
POST
/api/auth/login
Sign in — body: {"email","password"} — returns token
POST
/api/auth/logout
Sign out and invalidate session — requires Authorization header
GET
/api/auth/me
Get current user — requires Authorization header
POST
/api/auth/forgot-password
Request password reset — body: {"email"} — always returns success
POST
/api/auth/reset-password
Reset password — body: {"token","password"}
POST
/api/auth/find-account
Find account by name + company — body: {"name","company"}
POST
/api/auth/setup-2fa
Configure 2FA — body: {"method":"totp"} — returns TOTP URI

Authentication header format

All protected routes require the token from login in the HTTP header:

Authorization: Bearer ae-your-token-here

AI Agent Fortress™ API

All Fortress routes — requires auth token and fortress_enabled = 1 on your tenant.

🏰

All Fortress routes are under /api/fortress/ and require an Authorization: Bearer token header. If Fortress is not enabled for your tenant, routes return HTTP 403.

GET
/api/fortress/health
Platform health with all 15 sub-modules and post-quantum status
GET
/api/fortress/soc
SOC dashboard — active agents, risk events, containment, compliance posture
GET
/api/fortress/agents
Agent inventory with trust/risk scores — ?status=active&runtime=autogen
POST
/api/fortress/agents
Register agent — body: {"name","runtime","environment","permissions":[]}
GET
/api/fortress/agents/:id/trust-score
Agent trust score with band and event history
POST
/api/fortress/containment/action
Apply containment — body: {"agent_id","action":"restrict","reason":"..."}
POST
/api/fortress/compliance/generate
Generate evidence package — body: {"framework":"GDPR","period_start":"...","period_end":"..."}
GET
/api/fortress/quantum
Post-quantum architecture — algorithms, FIPS, key lifecycle, migration roadmap

Admin & Super-Admin API

All admin routes — require a token with role super_admin or admin.

GET
/api/admin/users
List users — ?limit=50&offset=0&search=query
GET
/api/admin/billing/failed-payments
All accounts with failed or suspended payments
POST
/api/admin/billing/notify-user
Send payment reminder — body: {"user_id","channel":"email|push|both","message":"..."}
POST
/api/admin/users/:id/suspend
Suspend account — body: {"reason":"..."}
POST
/api/admin/users/:id/unsuspend
Restore account access
POST
/api/admin/users/:id/remove
Permanently delete account — irreversible
GET
/api/admin/email/templates
List all 14 email templates
PUT
/api/cms
Update CMS content — body: {"section":"fortress","fields":{"module_name":"..."}}
PUT
/api/settings
Update platform settings — body: {"settings":{"payment_grace_period_days":"14"}}
POST
/api/pricing/update
Update module price — body: {"id":"crm","baseline_price":150}

Frequently Asked Questions

The most common questions about Aetherius — answered clearly.

Getting started

Do I need a server or hosting to run Aetherius?
No. Aetherius runs 100% on Cloudflare's global edge network. There are no servers to provision, no VMs to manage, and no hosting costs beyond Cloudflare's services — which have a generous free tier for testing and small deployments.
How long does deployment take?
A first-time deployment takes about 60–90 minutes following the DEPLOYMENT-GUIDE.md included in the package. This includes installing tools, creating Cloudflare services, deploying the Worker, seeding the database, and creating the first Super-Admin account. Subsequent updates (code changes, config changes) take under 2 minutes.
Is technical knowledge required?
Minimal. The deployment guide is written for non-technical founders. You need to be comfortable copy-pasting commands into a terminal window and following step-by-step instructions. No coding knowledge is required. The trickiest part is filling in your Cloudflare service IDs in the configuration file — but the guide shows exactly where to find each one.
Is this package completely self-contained?
Yes. The aetherius-v3-complete.zip file contains everything needed: the complete Worker code (2,147 lines covering all modules), the full database schema and seed data, the marketing website with the documentation and FAQ center (this page), all deployment scripts, and a complete step-by-step deployment guide. No other files are needed from previous versions.

AI Agent Fortress™

Can customers choose individual Fortress sub-modules?
No. AI Agent Fortress™ is always all-or-nothing. When a tenant's plan includes Fortress, they get all 15 sub-modules together. This is by design — the sub-modules share a unified data model (agents, identities, risk events, flight logs, compliance evidence) that only works coherently as a complete system.
Can I rebrand AI Agent Fortress™ to a different name?
Yes. The module name is stored in the CMS table (section: 'fortress', field: 'module_name') and can be updated by Super-Admin at any time via PUT /api/cms — no code changes or redeployment needed. The change propagates globally immediately.
Does Fortress require external AI APIs?
No. The Autonomous Risk Engine uses heuristics, statistical analysis, and behavioural baselines — no LLM inference is needed for risk detection. The Quantum Trust Layer uses Rust/WASM cryptography — no external PKI. The only component that uses AI is the cognitive query interface, which routes to Workers AI (Mode 1 — fully sovereign). If Workers AI is not configured, those routes return demo responses instead of errors.
What happens to an agent's active work when it is contained?
At Warn and Restrict levels, the agent continues running with reduced permissions — in-flight work completes. At Freeze, the agent is paused and pending actions are queued (not discarded). At Quarantine, the agent is isolated and pending actions require manual review before processing. At Terminate, the agent is permanently ended and all pending actions are discarded. Containment events are always logged to the immutable audit trail.

Billing & Payments

What happens to a user when their payment fails?
When POST /api/billing/payment-failed is called (typically by a Stripe or other payment webhook), three things happen simultaneously: (1) the user receives an in-app notification explaining the payment failure and warning that access will be suspended in 7 days, (2) a platform alert is created for Super-Admin showing the failed user, amount, and invoice ID, and (3) a 7-day grace period starts during which the user retains full access. Super-Admin can send additional reminders (push, email, or both) at any time during the grace period.
Can I change the grace period from 7 days?
Yes. Update the setting via: PUT /api/settings with body {"settings": {"payment_grace_period_days": "14"}}. This changes the grace period for all future payment failures. Existing grace periods already in progress are not affected.
When a user is suspended, what can they still access?
Nothing. Suspension blocks all access to the Aetherius platform — all 12 cloud suites, all 12 industry clouds, AI Agent Fortress™ (if enabled), and all API routes that require authentication. The user sees a suspension notice explaining the reason (payment overdue) and a link to update their payment method. They can still reach the public marketing website and documentation.

Pricing & Modules

Can I update pricing without redeploying the platform?
Yes. All module pricing is stored in the database and editable via POST /api/pricing/update with your Super-Admin token. Changes propagate instantly to the landing page (which fetches live pricing from the API), the billing engine, and all future invoices. No code changes or redeployment required.
How is AI Agent Fortress™ priced?
Fortress is seeded as a flat monthly add-on at $4,800/month for the full 15-sub-module bundle. Super-Admin can change this price at any time via the pricing editor. Fortress only appears and is only accessible to tenants with fortress_enabled = 1 in their tenant record, regardless of price.

Security & Compliance

Is Aetherius GDPR compliant?
Aetherius is designed with GDPR compliance as a foundation, not an afterthought. Key GDPR features: (1) Explainability Canvas 2.0 stores only hashes of AI inputs/outputs — no personal data in AI logs, (2) the /api/admin/users/export route provides a complete data export for data subject access requests, (3) the /api/admin/users/:id/remove route provides permanent data deletion (right to erasure), (4) all data is stored in Cloudflare D1 with configurable regional residency, (5) the Compliance Automation Center can generate a GDPR evidence package on demand.
Are passwords stored securely?
Yes. Passwords are hashed using PBKDF2 with SHA-256, 100,000 iterations, and a unique random 16-byte salt per password — implemented using the native Web Crypto API inside Cloudflare Workers. Raw passwords are never stored anywhere. This exceeds NIST SP 800-63B recommendations for password storage.

Troubleshooting

Solutions for the most common deployment and runtime issues.

Deployment issues

ErrorCauseFix
"Page can't be found" on worker URLworkers.dev subdomain not enabledDashboard → Workers & Pages → aetherius → Settings → Triggers → Enable workers.dev. Then run wrangler deploy again.
Bindings show "not configured"Must redeploy after adding bindings in dashboardRun wrangler deploy from the worker folder after adding bindings.
"wrangler: command not found"Node.js needs restart or reinstallRestart computer after installing Node.js, then try again.
"D1_ERROR: no such table"Schema not applied to databaseRun wrangler d1 execute aetherius-db --remote --file=database/schema.sql from the aetherius-v3 folder.
"database not found"Wrong database name in commandThe database must be named exactly aetherius-db. Check Cloudflare dashboard → D1.

API issues

SymptomLikely causeFix
401 Unauthorized on protected routesMissing or expired tokenInclude header: Authorization: Bearer your-token. Re-login if token expired.
403 on /api/fortress/* routesFortress not enabled for tenantRun scripts/enable-fortress.sql for your tenant.
400 on POST routesMissing required fields in JSON bodyCheck the API reference section for required fields. Include Content-Type: application/json header.
500 Internal Server ErrorDatabase not seeded or misconfiguredRun wrangler tail aetherius in terminal, trigger the request, and read the error message.
Bindings show "not configured" at /healthBindings not added in dashboard, or not redeployedAdd bindings in Cloudflare dashboard Settings → Bindings, then run wrangler deploy.

View live error logs

To see real-time error messages from your deployed Worker, run:

wrangler tail aetherius

Then trigger the failing request in your browser or Postman. The error will appear in the terminal within seconds.

Glossary

Key terms used throughout the Aetherius platform and documentation.

TermDefinition
AgentAn autonomous AI system that perceives inputs, makes decisions, and takes actions — registered and governed by AI Agent Fortress™
Agent Trust Score™Proprietary 0–100 score reflecting an agent's trustworthiness based on behaviour, policy adherence, and risk event history
BindingA connection between a Cloudflare Worker and a Cloudflare service (D1, KV, R2, Workers AI) — configured in the dashboard
CMSContent Management System — the Super-Admin interface for updating all public-facing text without code changes
Containment ladderThe 7-level escalation system for AI agent control: Observe → Warn → Restrict → Throttle → Freeze → Quarantine → Terminate
D1Cloudflare's serverless SQLite database — used by Aetherius for all structured data storage
FortressShort for AI Agent Fortress™ — the 15-sub-module enterprise AI agent governance platform
FIPS 203/204/205US federal standards for post-quantum cryptographic algorithms (ML-KEM, ML-DSA, SLH-DSA respectively)
Grace periodThe window after a payment failure (default: 7 days) during which the user retains access while payment issues are resolved
KVCloudflare Key-Value store — used by Aetherius for fast edge caching of sessions and settings
ML-DSA-65Module-Lattice Digital Signature Algorithm — FIPS 204 post-quantum digital signature scheme, used for agent certificates
ML-KEM-768Module-Lattice Key Encapsulation Mechanism — FIPS 203 post-quantum key exchange scheme
Mode 1 / Sovereign AIAI operation mode where all inference runs on Workers AI edge GPUs — zero data leaves Cloudflare, zero external API keys
OntologyThe unified semantic model underlying all Aetherius modules — entities like Account, Employee, and Agent carry relationships and shared context across all 12 clouds
R2Cloudflare's object storage service — used by Aetherius for document storage, exports, and compliance evidence archives
SLH-DSA-128sStateless Hash-Based Digital Signature — FIPS 205 post-quantum signature scheme used for long-lived audit evidence
Simu-CorpAetherius's strategic simulation engine — models 847 business variables across all domains simultaneously in under 3 seconds
Super-AdminThe highest-privilege user role in Aetherius — controls billing, RBAC, CMS, pricing, Fortress activation, and all tenant settings
TenantAn enterprise customer organisation within the Aetherius multi-tenant platform
Workers AICloudflare's edge AI inference service — enables Mode 1 sovereign AI with no external API keys
WranglerCloudflare's command-line tool for deploying Workers, managing D1 databases, and administering Cloudflare services