Assign Tag to Monitor

POST /api/monitor-tags

Body

{
  "monitorType": "website",
  "monitorId": 101,
  "tagId": 1
}

• monitorType (required): Type of the monitor. One of: website | dns | icmp | smtp | ssh | ftp | imap_pop.
• monitorId (required): Numeric ID of the monitor.
• tagId (required): Numeric ID of the tag to assign.

This operation is idempotent: calling it again when the tag is already assigned returns the existing assignment without error.

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X POST "$BASE_URL/api/monitor-tags" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"monitorType":"website","monitorId":101,"tagId":1}'

Response

{
  "monitorType": "website",
  "monitorId": 101,
  "tagId": 1,
  "createdAt": "2026-06-29T12:00:00.000Z"
}

Common errors

• 400 Bad Request when monitorType is not a supported type
• 401 Unauthorized when you are not logged in
• 403 Forbidden when you do not have read access to the monitor or cannot see the tag
• 404 Not Found when the monitor or tag does not exist