Tutorials

Create Monitors from CI with the Upmonora REST API

Use the Upmonora REST API and a bearer token to create, pause and resume monitors automatically from GitHub Actions or any CI pipeline.

Upmonora teamSeptember 17, 20262 min read

Overview - Create Monitors from CI with the Upmonora REST API

1. Create an API token

In the dashboard open Settings → API and create a token (Starter plan and above). It starts with um_live_ and is shown only once - store it as a CI secret.

2. Create a monitor

curl -X POST https://upmonora.com/api/v1/monitors \
  -H "Authorization: Bearer $UPMONORA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Preview: pr-142","url":"https://pr-142.preview.example.com","interval_seconds":60}'

3. Pause during deploys

curl -X POST https://upmonora.com/api/v1/monitors/$MONITOR_ID/pause -H "Authorization: Bearer $UPMONORA_TOKEN"
# … deploy …
curl -X POST https://upmonora.com/api/v1/monitors/$MONITOR_ID/resume -H "Authorization: Bearer $UPMONORA_TOKEN"

4. GitHub Actions example

- name: Pause Upmonora monitor
  run: |
    curl -fsS -X POST "https://upmonora.com/api/v1/monitors/${{ vars.UPMONORA_MONITOR_ID }}/pause" \
      -H "Authorization: Bearer ${{ secrets.UPMONORA_TOKEN }}"

Rate limits

Responses include X-RateLimit-Limit and X-RateLimit-Remaining. Limits depend on your plan (100 requests/minute on Starter).