APIReferenceDevices
Move a device to another server
POST
/devices/{id}/moveThe device keeps its ID, keys, name, limits and usage history. It gets an address on the new server, and the server's endpoint and key change, so the client needs the new config from the reply. With server_id: "auto" the server it is on now is never picked.
Needs the devices:write scope.
Authorization
apiKey AuthorizationBearer <token>
An API key: tp_….
In: header
Path Parameters
id*integer
Device ID.
Range
1 <= valueHeader 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.
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/devices/1/move" \ -H "Content-Type: application/json" \ -d '{ "server_id": 0 }'{ "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"}