Device security report

Execute scheduled security telemetry scenes on a provisioned device.

POSTapi.tikultra.com/v1/devices/{id}/reportHeavy · 10 credits

Upstream: /sdi/get_seed/ri/report
Access: Growth and up
Runs on: Primitive
Billing: Failed calls are free
Older path: /v1/contexts/{id}/report

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Path parameters

idstringrequired

The device ID. For example 7392011847562901234.

Body

Send JSON with content-type: application/json.

scenestring

full_sequence, cold_start, periodic, or auto. One of full_sequence, cold_start, periodic, auto.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

cURLPythonNode.js

curl -X POST https://api.tikultra.com/v1/devices/7392011847562901234/report \
  -H "x-api-key: $TIKULTRA_KEY" \
  -H "content-type: application/json" \
  -d '{"scene":"full_sequence"}'

Try ituses 10 credits

Run this endpoint with your own key in the dashboard playground. Every response shows its cost.

Open in playground

200 · sample

{
  "status": "ok",
  "device_id": "7392011847562901234",
  "scene": "full_sequence",
  "executed_reports": [
    "cold_start_112",
    "periodic_100",
    "auto_102"
  ],
  "report_sequence": 6
}