Uptimely

Create a monitor

POST
/v1/monitors

Creates a monitor through the same path as the dashboard wizard: product-default criteria (going offline auto-declares an incident that auto-resolves on recovery), initial Operational state, plan limits enforced. Website/API/External Status Page take url; Ping/IP/Port/DNS/SSL Certificate/Domain take host; Manual and Incoming Request/Email take no target. Data Check takes data_check (upAPI operation, write-only key, change paths) and defaults to an hourly cadence because every check is a billed upAPI call. Synthetic/script, SNMP and Server monitors must be created in the dashboard. API monitors also take request_type, request_headers, request_body and do_not_follow_redirects, and any monitor takes criteria instead of the product defaults. To assert on a redirect, create the monitor as type API with do_not_follow_redirects: true and a criteria list. This criteria expects a 301 whose Location is https://stealthly.io/: [{"name":"Redirect is missing or wrong","filterCondition":"Any","monitorStatusName":"Offline","createIncidents":true,"incidents":[{"title":"Canonical redirect is not 301 to the right URL"}],"filters":[{"checkOn":"Is Online","filterType":"False"},{"checkOn":"Response Status Code","filterType":"Not Equal To","value":301},{"checkOn":"Response Header","filterType":"Not Contains","value":"location: https://stealthly.io/"}]},{"name":"Redirect is correct","filterCondition":"All","monitorStatusName":"Operational","filters":[{"checkOn":"Response Status Code","filterType":"Equal To","value":301},{"checkOn":"Response Header","filterType":"Contains","value":"location: https://stealthly.io/"}]}] Criteria are an ordered, first-match-wins list; a check that matches none falls back to Operational, so list the failing case first. Send an Idempotency-Key header to make retries safe.

Authorization

bearerAuth
AuthorizationBearer <token>

An uptimely_live_ project API key (Settings → API Keys).

In: header

Header Parameters

Idempotency-Key?string

Optional client-generated key (1-255 visible ASCII characters; a UUID works) making this POST safely retryable. Retrying with the SAME key and byte-identical body within 24h replays the stored first response. The same key with a different body answers 422 idempotency_key_reused; a retry racing the first execution answers 409 idempotency_in_progress. Omitting the header executes normally with no idempotency guarantee.

Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/monitors" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "monitor_type": "string"  }'
{  "id": "string",  "slug": "string",  "name": "string",  "monitor_type": "string"}