Tunploy
APIReferenceDevices

Reset a device's usage

POST/devices/{id}/usage/reset

Starts the count toward the data limit again from now; a device blocked by its limit may connect at once. For plans that renew on their own date: use limit_period: total and reset on each renewal. History stays in the usage figures.

Needs the devices:write scope.

Authorization

apiKey
AuthorizationBearer <token>

An API key: tp_….

In: header

Path Parameters

id*integer

Device ID.

Range1 <= value

Header Parameters

Idempotency-Key?string

A retry with the same key within 24 hours gets the first reply back (with Idempotent-Replayed: true) instead of running again.

Lengthlength <= 255

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/devices/1/usage/reset"
{  "id": 0,  "server_id": 0,  "name": "string",  "external_id": "string",  "metadata": {},  "address": "10.8.0.2",  "public_key": "string",  "client_key": true,  "enabled": true,  "status": "active",  "online": true,  "last_handshake": "2019-08-24T14:15:22Z",  "data_limit": 0,  "limit_period": "monthly",  "period_usage": {    "rx_bytes": 0,    "tx_bytes": 0,    "total_bytes": 0  },  "usage_reset_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "speed_limit": 0,  "month_usage": {    "rx_bytes": 0,    "tx_bytes": 0,    "total_bytes": 0  },  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "config": "string"}