Update a device

PATCH

/devices/{id}

const url = 'https://localhost:8080/api/v1/devices/example';
const options = {
  method: 'PATCH',
  headers: {Authorization: '<Authorization>', 'Content-Type': 'application/json'},
  body: '{"is_location_public":true,"is_outdoor":true,"is_public":true,"name":"Balcony Sensor"}'
};

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

curl --request PATCH \
  --url https://localhost:8080/api/v1/devices/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "is_location_public": true, "is_outdoor": true, "is_public": true, "name": "Balcony Sensor" }'

Partially updates a device. Exact location can only be shared by a public device, and making a device private revokes location sharing.

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

Device id (UUID)

Request Body

Fields to update

application/json

object

is_location_public

boolean

is_outdoor

boolean

is_public

boolean

name

string

>= 1 characters <= 100 characters

Example

Balcony Sensor

Responses

200

application/json

object

data

object

created_at

string

device_id

string

is_location_public

boolean

is_outdoor

boolean

is_public

boolean

name

string

updated_at

string

Example

{
  "data": {
    "device_id": "dev_9f1c8a3b4d2e4f0a5b6c7d8e9f001122",
    "is_location_public": false,
    "is_outdoor": false,
    "is_public": false,
    "name": "Living Room Sensor"
  }
}

400

Bad Request

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"
}

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"
}

413

Request Entity Too Large

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"
}

415

Unsupported Media Type

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"
}