Skip to content
Protocol primitive

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/reportGrowth and up

Parameters

NameTypeDescription
idrequiredstringThe device ID.
e.g. 7392011847562901234
scenestringfull_sequence, cold_start, periodic, or auto.
e.g. full_sequence

Pricing

PlanPer callPer 1,000 calls
Starter10 credits$1.16
Growth10 credits$0.79
Scale10 credits$0.58

Growth and up.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

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"}'
{
  "status": "ok",
  "device_id": "7392011847562901234",
  "scene": "full_sequence",
  "executed_reports": [
    "cold_start_112",
    "periodic_100",
    "auto_102"
  ],
  "report_sequence": 6
}
Try it in the playgroundFull reference in the docs

More in Devices, signing & primitives

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.