Skip to Content
Uptimeify Docs
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. Use customer_domain for domain (SSL/expiry) monitors and customer_ip for 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 Request when monitorType or monitorId is missing or invalid
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden when you do not have read access to the monitor
  • 404 Not Found when the monitor does not exist

On this page