API Reference
The Axom API is a small REST surface over HTTPS. All endpoints live under https://console.axomlabs.ai/api.
Base URL
https://console.axomlabs.ai/apiNew here? Start with the guides — Train a model, Contract a model, Monitor & retrieve — which explain the how and why. This reference is the precise endpoint spec.
Authentication
Send your API key as a bearer token. See API keys.
bash
-H "Authorization: Bearer axom_live_…"Conventions
- JSON request and response bodies.
- Timestamps are ISO-8601 UTC.
- IDs are UUID strings.
- Errors return a non-2xx status with
{ "detail": "<message>" }. - Reads are scoped to your account automatically.
Endpoint groups
| Group | Description |
|---|---|
| API keys | Create and manage API keys |
| Jobs & runs | Submit train/contract runs, poll telemetry, fetch results |
| Models & datasets | Base models, your models, downloads, datasets |
| Pricing estimate | Quote the cost of a run before you submit it |
| Usage | Spend, tokens, and the dashboard overview |
| Errors | Status codes, error shape, idempotency, polling |