Change requests
Create Change Request
Opens a change request against any monitor (all monitor types).
POST /api/monitors/:monitorType/:monitorId/change-requests
Read access to the monitor is sufficient — the typical caller is a customer portal user who lacks write access to a managed monitor.
Path parameters
| Parameter | Description |
|---|---|
monitorType | One of website, dns, icmp, smtp, ssh, ftp, imap_pop, domain, dnsbl |
monitorId | Numeric ID of the monitor |
Request Body
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
kind | string | No | change | change (free-text wish) or request_managed (ask the org to take the monitor over) |
message | string | Yes | — | The request text (1–2000 chars) |
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X POST "$BASE_URL/api/monitors/website/103/change-requests" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"kind": "change",
"message": "Please lower the check interval to 1 minute."
}'Response
{
"id": 12,
"status": "open"
}Common errors
400 Invalid monitor type(invalidMonitorType) whenmonitorTypeis not one of the supported types400 Invalid monitor identifierwhenmonitorIdis not a positive integer401 Unauthorizedwhen you are not logged in403 Forbidden/404 Not foundwhen the monitor is outside your scope429 Too many open requests(tooManyOpenRequests) when the customer already has 10 open requests