POST /ci-checks
POST /api/v1/ci-checks files status, response time and certificate results from your own CI pipeline under the matching OwlHound monitor.
Request
POSThttps://owlhound.com/api/v1/ci-checks
Files one run's check results under your uptime monitors, matched by address, so the monitor page shows what your own pipeline saw. The owlhound-check GitHub Action and command line send these for you. CI results are shown for reference; they never count towards uptime, incidents or alerts. Results for an address you don't monitor are not stored; the answer lists them under unmatched.
Key: Any key (read-only or full). A read-only key is the safer choice for a CI secret.
| Parameter | Where | What |
|---|---|---|
results | JSON body, required | Up to 50 results. Each needs url and ok; status, ms, ssl_days and error are optional. |
source | JSON body, optional | github-action, cli or your own short name. |
run_url | JSON body, optional | An https link to the run, shown next to the result. |
Example
curl -X POST https://owlhound.com/api/v1/ci-checks \
-H "Authorization: Bearer $OWLHOUND_KEY" \
-H "Content-Type: application/json" \
-d '{"source": "cli", "results": [{"url": "https://example.com", "ok": true, "status": 200, "ms": 182, "ssl_days": 61}]}'Answer:
{"stored": [{"url": "https://example.com", "monitor_id": 12}], "unmatched": []}| Field | Meaning |
|---|---|
stored | Each result filed, with the monitor it went to: the one with the same address, or the only uptime monitor on that domain. |
unmatched | Addresses with no matching uptime monitor. Nothing is stored for them. |
Status codes
| Code | When |
|---|---|
401 | The key is missing, wrong or revoked. |
429 | More than 60 requests in a minute with this key. |
400 | The body isn't JSON, has no results or more than 50, or a result lacks url or ok. |
Other endpoints
List monitors · Get one monitor · Add a monitor · Delete a monitor · List incidents. Start at the API reference for keys and limits.
Start watching your site in minutes
Free for up to 10 sites, no card, nothing to install. Read-only access you can revoke at any time — never passwords, never admin access.