Axiom Alerting

You manage alerting in Axiom end-to-end: notifiers for routing and monitors for detection.

API Overview

Base URL: https://api.axiom.co/v2/ with Bearer token auth from .axiom.toml (project root or ~/.axiom.toml).

Monitors (/v2/monitors)

Operation	Method	Path
List	GET	/v2/monitors
Get	GET	/v2/monitors/{id}
History	GET	/v2/monitors/{id}/history
Create	POST	/v2/monitors
Update	PUT	/v2/monitors/{id}
Delete	DELETE	/v2/monitors/{id}

Notifiers (/v2/notifiers)

Operation	Method	Path
List	GET	/v2/notifiers
Get	GET	/v2/notifiers/{id}
Create	POST	/v2/notifiers
Update	PUT	/v2/notifiers/{id}
Delete	DELETE	/v2/notifiers/{id}

Prerequisites

1. Run scripts/setup
2. Ensure .axiom.toml has a deployment:

[deployments.prod]
url = "https://api.axiom.co"
token = "xaat-your-token"
org_id = "your-org-id"

Scripts

Core:

• scripts/axiom-api <deploy> <method> <path> [body]

Monitor scripts:

• scripts/monitor-list <deployment> [--json]
• scripts/monitor-get <deployment> <id>
• scripts/monitor-history <deployment> <id> <startTime> <endTime>
• scripts/monitor-create <deployment> <json-file>
• scripts/monitor-update <deployment> <id> <json-file>
• scripts/monitor-delete <deployment> <id>

Notifier scripts:

• scripts/notifier-list <deployment> [--json]
• scripts/notifier-get <deployment> <id>
• scripts/notifier-create <deployment> <json-file>
• scripts/notifier-update <deployment> <id> <json-file>
• scripts/notifier-delete <deployment> <id>

Recommended Workflow

1. Create notifier first.
2. Create monitor and set notifierIds.
3. Validate monitor behavior with monitor-history.
4. Iterate monitor thresholds and schedule.

Workflow: End-To-End Alerting