WardenPoint Python SDK

Official Python SDK for WardenPoint — incident alerting and on-call escalation. Fire and manage alerts from your apps, jobs and pipelines; page on-call automatically when code fails.

Install

pip install wardenpoint

Quickstart

from wardenpoint import WardenPoint

wp = WardenPoint(api_key="wp_live_xxx")        # or set WARDENPOINT_API_KEY

# send to a recipient (UUID or exact name) at a priority
wp.alerts.send(recipient="ops-oncall", message="DB primary down", priority="high")

# send to a whole group
wp.alerts.send_to_group(group="<group-uuid>", message="API SLO burn", priority="critical")

# fire a pre-configured template
wp.templates.fire("disk-full", vars={"host": "web-3", "pct": 95}, override={"priority": "high"})

# inspect / acknowledge / cancel
wp.alerts.list()
wp.alerts.status("<id>")
wp.alerts.acknowledge("<uuid>")
wp.alerts.cancel("<uuid>")
wp.recipients.list()

Priorities: low, normal, high, critical.

templates.fire(...) requires alert templates to be enabled for your company (a per-tenant setting in the dashboard); otherwise the call returns an APIError.

Page automatically when code fails

The context manager and decorator alert on-call with the exception and traceback if the wrapped code raises — then re-raise, so behaviour is unchanged otherwise. A delivery failure never masks your original error.

# context manager
with wp.guard(group="sre", title="nightly ETL"):
    run_etl()

# decorator for jobs
@wp.on_failure(to="ops-oncall", priority="high")
def reconcile_invoices():
    ...

Configuration

WardenPoint is also a context manager (closes the HTTP client on exit):

with WardenPoint(api_key="...") as wp:
    wp.alerts.send(recipient="...", message="...")

Errors

• wardenpoint.APIError — non-2xx response (.status, .message, .body).
• wardenpoint.WardenPointError — config / validation / resolution errors.

Development

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.