Tags
List Monitor Tags
Returns all tags assigned to a specific monitor. Readonly members see only their own tags.
GET /api/monitor-tags
Query Parameters
monitorType(required): Type of the monitor. One of:website|dns|icmp|smtp|ssh|tcp|ftp|imap_pop|customer_domain|customer_ip. Usecustomer_domainfor domain (SSL/expiry) monitors andcustomer_ipfor DNSBL/blacklist monitors.monitorId(required): Numeric ID of the monitor.envelope(string, optional):items: answer as{ items, total, page, perPage }. Becomes the default on 2027-01-18.
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/monitor-tags?monitorType=website&monitorId=101&envelope=items" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Response
{
"items": [
{
"id": 1,
"publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"organizationId": 10,
"name": "Production",
"color": "red",
"createdBy": 42,
"createdAt": "2026-06-01T08:00:00.000Z",
"updatedAt": "2026-06-01T08:00:00.000Z"
}
],
"total": 1,
"page": 1,
"perPage": 1
}List form: with envelope=items the list arrives as { items, total, page, perPage }. Without it the endpoint still answers the current form (a bare array of the same items), which is deprecated; { items, ... } becomes the default on 2027-01-18.
Common errors
400 Bad RequestwhenmonitorTypeormonitorIdis missing or invalid401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you do not have read access to the monitor404 Not Foundwhen the monitor does not exist
Remove Tag from Monitor
Removes a tag assignment from a monitor. The caller must have read access to the monitor.
Maintenance Windows
Create and manage maintenance windows to suppress alerts during planned work. Windows can target a single monitor, multiple monitors, an entire customer, or any monitor carrying a given tag.