Tags

Delete Tag

Deletes a tag and removes it from all monitors it was assigned to. Only the tag owner or an admin may delete a tag.

DELETE /api/tags/{id}

Path parameter {id} is the tag's numeric id.

Deleting a tag cascades: all monitor-tag assignments for that tag are also removed automatically.

Example (cURL)

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

curl -X DELETE "$BASE_URL/api/tags/$TAG_ID" \
  -H "Authorization: Bearer $TOKEN"

Response

Returns 204 No Content on success.

Common errors

401 Unauthorized when you are not logged in
403 Forbidden when you are not the tag owner or an admin
404 Not Found when the tag does not exist or is not visible to you

Update Tag

Updates an existing tag's name or color. Only the tag owner or an admin may update a tag.

Assign Tag to Monitor

Assigns an existing tag to a monitor. The caller needs read access to the monitor and visibility of the tag. The operation is idempotent.

On this page

Example (cURL)Response Common errors