Recipes

Restart Devices

Automation

GET /v1/devices

POST /v1/tasks

Restart the devices that support the task, and confirm they return online.

You can adjust the script to your needs. Change the conditions, variables, and values to produce the output you want.

import json
import time

import requests

BASE = "https://api.securithings.com"
headers = {"Authorization": f"Bearer {access_token}"}

devices = requests.get(
    f"{BASE}/v1/devices",
    params={"limit": 100},
    headers=headers,
).json()["devices"]

targets = [
    device["id"]
    for device in devices
    if device["availableTask"]["restartDevice"]
]

response = requests.post(
    f"{BASE}/v1/tasks",
    json={
        "taskType": "restartDevice",
        "devices": [
            {"deviceId": device_id}
            for device_id in targets
        ],
    },
    headers=headers,
)
task_id = response.json()["taskId"]

while True:
    task = requests.get(
        f"{BASE}/v1/tasks/{task_id}",
        headers=headers,
    ).json()
    pending = [
        device_task
        for device_task in task["deviceTasks"]
        if device_task["status"] != "completed"
    ]
    if not pending:
        break
    time.sleep(30)

result = {"taskId": task_id, "devices": []}

for device_id in targets:
    device = requests.get(
        f"{BASE}/v1/devices/{device_id}",
        headers=headers,
    ).json()
    result["devices"].append(
        {
            "id": device["id"],
            "name": device["name"],
            "status": device["status"],
        }
    )
    time.sleep(1)  # 1 request per second

print(json.dumps(result, indent=2))

Output

{
"taskId": "23bpozz1mpjjedtr",
"devices": [
  {
    "id": "9ff559ee-38b6-11f1-81cb-465864a35d0a",
    "name": "192.168.2.69 - Unit",
    "status": "online"
  },
  {
    "id": "dc7d4ef1-6bf9-11f1-b083-d27bafcacdf8",
    "name": "192.168.2.70 - Unit",
    "status": "offline"
  }
]
}

Onboard Discovered Devices Rotate Device Passwords