Rotate a device's secret key

POST

/devices/{id}/rotate-key

const url = 'https://localhost:8080/api/v1/devices/example/rotate-key';
const options = {method: 'POST', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://localhost:8080/api/v1/devices/example/rotate-key \
  --header 'Authorization: <Authorization>'

Generates a new device_key for the device, invalidating the old one immediately. The new key is shown only in this response; update the physical device with it right away.

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

Device id (UUID)

Responses

200

application/json

object

data

object

created_at

string

device_id

string

device_key

string

is_location_public

boolean

is_outdoor

boolean

is_public

boolean

name

string

updated_at

string

Example

{
  "data": {
    "device_id": "dev_9f1c8a3b4d2e4f0a5b6c7d8e9f001122",
    "device_key": "sk_1a2b3c4d5e6f...store this now, it won't be shown again",
    "is_location_public": false,
    "is_outdoor": false,
    "is_public": false,
    "name": "Living Room Sensor"
  }
}

401

Unauthorized

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

404

Not Found

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

422

Unprocessable Entity

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}

500

Internal Server Error

application/json

object

detail

string

errors

Array<object>

object

code

string

detail

string

Allowed values: body query path

name

string

instance

string

status

integer

title

string

type

string

Example

{
  "detail": "One or more request values are invalid.",
  "errors": [
    {
      "code": "required",
      "detail": "name is required",
      "in": "body",
      "name": "name"
    }
  ],
  "instance": "/api/v1/devices",
  "status": 422,
  "title": "Request validation failed",
  "type": "https://docs.air-iq.net/reference/errors/#validation-error"
}