Skip to main content

Request settings

Request settings describe the exact HTTP request that Uptimus sends to your monitor URL.

HTTP method

Use GET for normal websites and pages. Use HEAD, POST, PUT, PATCH or DELETE only when the endpoint expects that method.

If a method is not accepted by your server, the server may return 405 Method Not Allowed. That is a real server response, not a Uptimus UI error.

Headers

Extra request headers are optional. Add them only when your endpoint requires values such as API version, tenant, content type or authorization metadata.

Avoid storing secrets in plain headers unless the monitor is specifically meant for a private endpoint and your team understands the exposure.

Headers are normalized before they reach monitoring agents. Unsafe header names and newline characters are rejected so a monitor cannot inject malformed HTTP requests.

Payload

Payload fields are optional and are sent with non-GET requests. Use them when an API endpoint requires form-like data.

Raw body is optional and can be used for JSON or custom payloads. When raw body is present, it is treated as the source of truth for the request body.

Use payload fields for simple form-style checks. Use raw body when the endpoint expects JSON, XML or a vendor-specific format.

Magic variables

Magic variables make every request unique without editing the monitor manually.

VariableMeaning
$UPTIMUS_TIMESTAMPUnix timestamp in seconds
$UPTIMUS_ISO8601Current timestamp in ISO-8601 format
$UPTIMUS_UUIDRandom UUID for this check
$UPTIMUS_RANDOMRandom short token for this check

Use them in headers, payload values, raw body or URLs when you need cache-busting or idempotency keys.

Redirects

Use max redirects to limit redirect loops. Use expected final redirect URL when the final destination matters, such as checkout, login or a canonical domain.

If your server redirects to another URL and the final URL does not match the expected value, Uptimus marks the check as failed. This helps catch broken canonical redirects, wrong regions and accidental login redirects.