Plum / developers
REST APIDevice

Report device activity

Report activity for a bound device. Set Content-Type to application/json or application/cbor for the request body. Requires a provisioned, verified mTLS device client certificate and an account binding. Set Accept to application/json or application/cbor for the response; omitted or wildcard Accept selects JSON. See [Devices](/docs/devices).

POST/device/activity

Header Parameters

X-API-Version?"1"

Send 1 to pin the documented API contract. If omitted, the latest version is selected.

Default"1"

Value in

  • "1"

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://example.com/device/activity" \  -H "X-API-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "listening": true,    "binding_epoch": "f92bd0f6-ad82-48f7-b45e-7b07b52b3f71"  }'
{  "success": true,  "data": {    "listening": true,    "last_seen_at": "2019-08-24T14:15:22Z",    "expires_at": "2019-08-24T14:15:22Z"  }}