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).