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 withquotes:writeanddecisions: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.