Device API

The device API is used for updating device information registered with our IoT identity provider.

Update Device Public Key Endpoint

Use this endpoint to update the public key of a registered device. To ensure that only a genuine device can update its public key, the device has to authenticate by providing a private key JWT. Furthermore the device has to provide a proof of possession (PoP) object to demonstrate possession of the private key corresponding to the public key it tries to update.

For additional details about the JWT and the PoP object visit our developer guide.

Renew public key

POST coaps://iot-idp.demo.coap-apps.iothentix.io/device/update/pubkey

Request Body

Name	Type	Description
pop*	String	Proof of Possession object
client_secret*	String	Signed JWT containing the new public key.

400: Bad Request The request format was incorrect.

403: Forbidden The private key JWT was invalid.

500: Internal Server Error Internal error in the IdP infrastructure.

201: Created Successful update of the registered public key

{
    "Success": "Public key updated"
}

405: Method Not Allowed The requested method is not allowed for this resource.