Allometry  /  Docs
Documentation

Build on the decision layer.

Concept guides, API reference, and integration recipes. Everything you need to wire Allometry into your CRM, ERP, FSM, and warehouse — and ship the loop.

Live · the API request flow POST → score → respond · 200 OK · ~40ms median · 18s loop
REQUEST POST /v1/score { deal_id, lines } → priced → margin_score SCORE ENGINE ~40ms p50 RESPONSE 200 OK { "margin": 34.2, "route": "Q-04", "risk": 0.18 } 14 ENDPOINTS · TYPED · VERSIONED SDK · TS · PY · GO
§ 01 · Start here

Get to the loop in 15 minutes.

Connect a workspace, score a sample of accounts, and walk through your first quote — autonomously priced against your live cost model.

— 12 guides
§ 02 · Concepts

The four loops, formally.

How Price, Deploy, Expand, and Govern compose. Decision substrate, policy as code, the model registry, and how autonomy is earned per loop.

— 18 articles
§ 03 · API reference

REST & GraphQL. Idempotent.

Read signal, write decisions, stream the audit trail. Versioned, paginated, idempotent — with TypeScript and Python SDKs.

— 84 endpoints
§ 04 · Recipes

Patterns we've shipped with operators.

Composable recipes for the most common moves — territory rebuilds, margin guard rollouts, contract intelligence ingestion, ABM orchestration.

— 24 recipes

Quickstart · the 15-minute path

This guide walks you through the minimum viable setup: a workspace, a connected CRM, a connected cost source, and your first autonomously-priced quote. By the end, you'll have a live decision in the audit log, attributable to a model and a policy, with a reproducible input snapshot.

Prerequisites

  • workspaceAn Allometry workspace — created during onboarding or via the SSO admin console.
  • api tokenA workspace-scoped API token with quotes:write and decisions:read.
  • cost sourceEither an ERP connection or a CSV upload of your live cost model — Allometry needs cost truth to price work.

1 · Create a token

Open the workspace admin, navigate to Settings → API Tokens, and create a token scoped to quotes:write and decisions:read. Tokens are workspace-scoped and can be rotated independently.

# Export your token to the environment
export ALLOMETRY_TOKEN="alm_live_••••••••••"
export ALLOMETRY_WORKSPACE="acme-prod"

2 · Score & price a quote

The POST /v1/quotes endpoint accepts a structured request describing the work, returns a priced quote against your live cost model, and writes a decision record to the audit trail. The call is idempotent — pass Idempotency-Key to safely retry.

curl https://api.allometry.com/v1/quotes \
  -H "Authorization: Bearer $ALLOMETRY_TOKEN" \
  -H "Idempotency-Key: req_2026_04_29_001" \
  -d '{
    "account_id": "acc_98a2",
    "scope": { "loop": "price", "module": "quoting-engine" },
    "items": [
      { "sku": "EVSE-DCFC-180", "qty": 4 },
      { "sku": "INSTALL-T2", "qty": 1 }
    ],
    "policy_version": "v3.2-prod"
  }'

3 · Read the decision back

Every quote produces a decision record — model version, policy version, feature snapshot, and output. You can read it back, stream it to your warehouse, or replay it against a new policy version to see how the answer would have changed.

curl https://api.allometry.com/v1/decisions/dec_2j8x \
  -H "Authorization: Bearer $ALLOMETRY_TOKEN"

What's next

You've shipped a single decision. The full loop kicks in once you wire signal back — connect Salesforce so account context flows in, connect the ERP so cost truth stays current, and stream the audit log to your warehouse so the operator dashboard has lineage. The connect Salesforce guide is the natural next step.

Support

Stuck? Talk to a human.

Every workspace gets a Slack Connect channel with our integration engineers. For partners, we also run weekly office hours.

— STATUS
API · v1● Operational
Decision substrate● Operational
Webhooks● Operational
Inference fleet● Operational
90-day uptime · 99.987 %
Last incident · 22 days ago