Back to DocsRecipe

Recipe: Pager rotation policy writer

Define on-call escalation chains and rotation windows so alerts never land in a void. This recipe wires Meridian's signal bus to your pager policy store.

Ingredients

  • Meridian API key with policy:write scope
  • Team roster exported as JSON (Slack UID → phone)
  • Rotation cadence: daily, weekly, or follow-the-sun

Steps

  1. 1POST your roster to /v1/policies/rotation with a window_start ISO-8601 timestamp.
  2. 2Meridian computes the active shard and returns a policy_id. Store it — you'll reference it in alert rules.
  3. 3Attach the policy to a monitor group via PATCH /v1/monitors/{id}.

Tip: Run a cron every Sunday at 00:00 UTC to advance the rotation window. Meridian will auto-escalate unacked pages after 15 minutes.

← All recipes