For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tamper

API to manage tamper detection sensors.

List tamper sensors.

get

List all available tamper sensor resources.

Authorizations
hue-application-keystringRequired
Responses
200

Tamper Success Response

application/json
get/clip/v2/resource/tamper
GET /clip/v2/resource/tamper HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Accept: */*
{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "owner": {
        "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
        "rtype": "device"
      },
      "tamper_reports": [
        {
          "changed": "2026-01-01T00:00:00.000Z",
          "source": "text",
          "state": "tampered"
        }
      ]
    }
  ]
}

Get tamper sensor.

get

Get details of a single tamper sensor resource from its given {tamperId}.

Authorizations
hue-application-keystringRequired
Path parameters
tamperIdstringRequired

ID of the tamper sensor

Responses
200

Tamper Success Response

application/json
get/clip/v2/resource/tamper/{tamperId}
GET /clip/v2/resource/tamper/{tamperId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Accept: */*
{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "type": "light",
      "id": "3883f8bf-30a3-445b-ac06-b047d50599df",
      "id_v1": "/lights/8",
      "owner": {
        "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
        "rtype": "device"
      },
      "tamper_reports": [
        {
          "changed": "2026-01-01T00:00:00.000Z",
          "source": "text",
          "state": "tampered"
        }
      ]
    }
  ]
}

Update tamper sensor.

put

Update a single tamper sensor resource from its given {tamperId}.

Authorizations
hue-application-keystringRequired
Path parameters
tamperIdstringRequired

ID of the tamper sensor

Body
typestringOptional

Type of the supported resources (always tamper here)

Responses
200

Success

application/json
put/clip/v2/resource/tamper/{tamperId}
PUT /clip/v2/resource/tamper/{tamperId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "type": "text"
}
{
  "errors": [
    {
      "description": "text"
    }
  ],
  "data": [
    {
      "rid": "42edd1f5-9538-4180-9ced-2d9e07f26d0f",
      "rtype": "device"
    }
  ]
}

Last updated

Was this helpful?