Supercheck LogoSupercheck
Monitors API

Add or remove monitor tags

Atomically add and/or remove individual tags without replacing the whole set, so concurrent changes are not lost. Requires monitor:update. Removed tags are applied first; adding an already-assigned tag or removing an unassigned tag is a no-op. Added tags must exist in the current project and the result may hold at most 10 tags (400 otherwise). The same tag cannot be in both lists.

PATCH
/api/monitors/{id}/tags

Authorization

bearerAuth
headerAuthorizationBearer <token>

Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.

Path Parameters

id*string

Monitor ID

Formatuuid

Request Body

application/json
  1. body
add?array<>
Itemsitems <= 10
remove?array<>
Itemsitems <= 10

Response Body

Updated tag list

application/json
  1. response
tags?array<>
Example Request
curl -X PATCH 'https://demo.supercheck.dev/api/monitors/497f6eca-6276-4993-bfeb-53cbbbba6f08/tags' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "tags": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "color": "string"    }  ]}