Motion

API to manage motion services. These are offered by devices with motion sensing capabilities.

List motion sensors.

get

List all available motion sensors.

Authorizations

hue-application-keystringRequired

Responses

200

Motion Success Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

get/clip/v2/resource/motion

GET /clip/v2/resource/motion 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"
      },
      "enabled": true,
      "motion": {
        "motion": true,
        "motion_valid": true,
        "motion_report": {
          "changed": "text",
          "motion": true
        }
      },
      "sensitivity": {
        "status": "set",
        "sensitivity": 1,
        "sensitivity_max": 1
      }
    }
  ]
}

Get motion sensor.

get

Get details of a single motion sensor from its given {motionId}.

Authorizations

hue-application-keystringRequired

Path parameters

motionIdstringRequired

ID of the motion sensor

Responses

200

Motion Success Response

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

get/clip/v2/resource/motion/{motionId}

GET /clip/v2/resource/motion/{motionId} 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"
      },
      "enabled": true,
      "motion": {
        "motion": true,
        "motion_valid": true,
        "motion_report": {
          "changed": "text",
          "motion": true
        }
      },
      "sensitivity": {
        "status": "set",
        "sensitivity": 1,
        "sensitivity_max": 1
      }
    }
  ]
}

Update Motion Sensor

put

Update a single motion sensor from its given {motionId}.

Authorizations

hue-application-keystringRequired

Path parameters

motionIdstringRequired

Id of the motion sensor

Body

typestringOptional

Type of the supported resources (always motion here)

enabledbooleanOptional

true when the sensor is activated, false when deactivated

Responses

200

Success

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

put/clip/v2/resource/motion/{motionId}

PUT /clip/v2/resource/motion/{motionId} HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "enabled": true
}

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